Merge pull request '#114 refactor(ai-chat): shared parseNodeArg helper; keep duplication backlog doc' (#114) from refactor/ai-chat-tool-spec-registry into develop

# Conflicts:
#	apps/server/src/core/ai-chat/tools/ai-chat-tools.service.ts

docs/backlog/ai-chat-tool-definitions-duplicated.md

@@ -1,8 +1,26 @@
 # Дублирование определений инструментов: in-app агент vs standalone MCP-пакет
 
-Статус: **зафиксировано в беклоге, код не менялся.** Это forward-looking
-стоимость поддержки, НЕ баг — код корректен сегодня. Фиксируем, чтобы при
-росте набора инструментов (см. §16) долг не разъезжался молча.
+Статус: **частично закрыто.** Квирк «node как объект ИЛИ JSON-строка» вынесен
+в общий хелпер `parseNodeArg` (см. «Прогресс» ниже); остальной долг (единый
+реестр спеков + унификация конвертера) всё ещё открыт. Это forward-looking
+стоимость поддержки, НЕ баг — код корректен сегодня. Держим запись открытой,
+чтобы при росте набора инструментов долг не разъезжался молча.
+
+## Прогресс
+
+- ✅ **Квирк node-arg вынесен в хелпер** (`refactor/ai-chat-tool-spec-registry`,
+  PR #114). Шесть рукописных копий нормализации «node как объект ИЛИ
+  JSON-строка» свёрнуты в `parseNodeArg`: по одному источнику на пакет —
+  `packages/mcp/src/lib/parse-node-arg.ts` (standalone) и
+  `apps/server/src/core/ai-chat/tools/parse-node-arg.ts` (in-app). Две копии
+  намеренны (ESM/CJS-граница), поведение тождественно.
+- ⏳ **Единый реестр спеков** (схема + описание на инструмент) и **вывод
+  `DocmostClientLike` из реального типа** — отложены (см. «Фикс»): требуют
+  пересечения ESM/CJS-границы для данных+zod и ломают тест-стабы in-app
+  инструментов при точных типах. Делать инкрементально.
+- ⏳ **Унификация конвертера ProseMirror ↔ Markdown** — открыта (см. раздел
+  «Расширение …» ниже); на неё опирается план git-синка
+  (`docs/git-sync-plan.md`).
 
 ## Суть
 
@@ -28,12 +46,13 @@ parity-баги (расхождение копий) приходится чин
 ## Что именно продублировано (с подтверждением по коду)
 
 - **zod-схема + описание** каждого инструмента — в слоях 1 и 2 целиком.
-- **Квирк «node как объект ИЛИ JSON-строка»** реализован дважды (НЕ в общем
-  клиенте):
-  - in-app: `ai-chat-tools.service.ts:686` (patchNode), `:745` (insertNode),
-    `:800` (updatePageJson);
-  - standalone: `index.ts:526` (patch_node), `:578` (insert_node), `:350`
-    (update_page_json).
+- ~~**Квирк «node как объект ИЛИ JSON-строка»** реализован дважды (НЕ в общем
+  клиенте)~~ — **закрыто (PR #114):** вынесен в `parseNodeArg` (по хелперу на
+  пакет), 6 inline-копий устранены:
+  - in-app: `patchNode`, `insertNode`, `updatePageJson` →
+    `apps/server/src/core/ai-chat/tools/parse-node-arg.ts`;
+  - standalone: `patch_node`, `insert_node`, `update_page_json` →
+    `packages/mcp/src/lib/parse-node-arg.ts`.
 - **Guardrail/семантика `transformPage` (dryRun)** описана в обоих:
   `ai-chat-tools.service.ts:~935` и `index.ts:~1006`.