@daisforge/ui-mcp 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/README.md +11 -1
  2. package/data/component-index.json +31206 -19240
  3. package/dist/indexer/buildIndex.js +49 -2
  4. package/dist/indexer/buildIndex.js.map +1 -1
  5. package/dist/indexer/collectUsageExamples.js +10 -2
  6. package/dist/indexer/collectUsageExamples.js.map +1 -1
  7. package/dist/indexer/indexFeatures.js +1 -13
  8. package/dist/indexer/indexFeatures.js.map +1 -1
  9. package/dist/indexer/indexTypes.js +2 -4
  10. package/dist/indexer/indexTypes.js.map +1 -1
  11. package/dist/indexer/loadMeta.js +49 -0
  12. package/dist/indexer/loadMeta.js.map +1 -0
  13. package/dist/indexer/mergeMeta.js +1 -13
  14. package/dist/indexer/mergeMeta.js.map +1 -1
  15. package/dist/indexer/parseComponent.js +162 -12
  16. package/dist/indexer/parseComponent.js.map +1 -1
  17. package/dist/indexer/resolveImportPath.js +101 -0
  18. package/dist/indexer/resolveImportPath.js.map +1 -1
  19. package/dist/indexer/synthesizeExample.js +10 -0
  20. package/dist/indexer/synthesizeExample.js.map +1 -1
  21. package/dist/indexer/vendorExamples.js +7 -2
  22. package/dist/indexer/vendorExamples.js.map +1 -1
  23. package/dist/resolveIndex.js +22 -2
  24. package/dist/resolveIndex.js.map +1 -1
  25. package/dist/server.js +1 -1
  26. package/dist/server.js.map +1 -1
  27. package/dist/tools/getType.js +105 -2
  28. package/dist/tools/getType.js.map +1 -1
  29. package/dist/tools/searchComponents.js +96 -12
  30. package/dist/tools/searchComponents.js.map +1 -1
  31. package/dist/types.js.map +1 -1
  32. package/dist/validate/checkCompleteness.js +65 -0
  33. package/dist/validate/checkCompleteness.js.map +1 -0
  34. package/dist/validate/validateIndex.js +9 -0
  35. package/dist/validate/validateIndex.js.map +1 -1
  36. package/package.json +4 -3
package/README.md CHANGED
@@ -67,6 +67,16 @@ npm run mcp:build-index
67
67
 
68
68
  Пишет `packages/mcp-server/data/component-index.json` (запасной индекс, вшивается в публикуемый `@daisforge/ui-mcp`) и, если уже собран `dist/packages/ui-kit` — также `dist/packages/ui-kit/mcp-data/component-index.json` (уезжает вместе с публикацией `@daisforge/ui`). Автоматически запускается после `npm run build` (см. корневой `postbuild`).
69
69
 
70
+ ### Курированная мета — обязательный вход, а не опция
71
+
72
+ `_docs/meta/components-meta.json` лежит в `.gitignore` (это build-артефакт `npm run meta`), поэтому на свежем клоне и в CI его нет. Без него из индекса молча исчезает всё, что приходит только оттуда: **features** (77 записей, 46 из них у одного `TableCanvas`), **guides.installation**, curated-описания/`keywords`/`chooseWhen` ui-kit компонентов и все примеры типа **full-code**. Ровно такой выпотрошенный индекс уехал в npm `0.1.1` — у потребителя `list_features` отвечал `0`, а поиск по фичам не находил ничего.
73
+
74
+ Поэтому:
75
+
76
+ - `mcp:build-index` и корневой `postbuild` сами вызывают `npm run meta` перед сборкой индекса;
77
+ - индексер падает на старте, если меты всё-таки нет (`assertMetaAvailable` в `src/indexer/loadMeta.ts`); осознанно собрать неполный индекс — `MCP_INDEX_ALLOW_MISSING_META=1`;
78
+ - перед записью индекс проходит проверку наполненности (`src/validate/checkCompleteness.ts`): при обвале любого источника (features, full-code примеры, curated-доки, типы, compound-части, гайд по установке) файл **не записывается**, прогон падает. Та же проверка идёт первым шагом в `mcp:validate-index`.
79
+
70
80
  ## Резолв индекса — три уровня
71
81
 
72
82
  1. **workspace** — если рядом физически лежит `packages/ui-kit` (мы внутри монорепо), сервер читает свежесобранный локальный индекс.
@@ -92,7 +102,7 @@ npm run mcp:vendor-atomic -- --source /путь/к/plasma/website/sdds-finai-doc
92
102
  Перед обновлением стоит знать две особенности снэпшота (подробно — `ARCHITECTURE.md` §1.6b):
93
103
 
94
104
  - **`generate-mcp-data` даёт один файл на СТРАНИЦУ доков, не на атом**, и берёт со страницы только первую таблицу пропсов. В доках 87 таблиц `<PropsTable>` на 74 страницы — 14 таблиц (`AccordionItem`, `CalendarBase`, `Col`, `DatePickerRange`, `ListItem`, `NotificationsProvider`, `SegmentItem`, `RectSkeleton`/`TextSkeleton`, `TabItem`/`TabsController` и др.) в снэпшот не попадают вовсе. Прирост от перевендоринга будет заметным только вместе с исправлением их `extractProps`.
95
- - **Проверяйте версию**: `vendor/atomic-mcp-data/manifest.json` содержит версию `@salutejs/sdds-finai`, из которой собран текущий снэпшот (сейчас `0.349.0`). Прогон на более старом чекауте plasma перезапишет снэпшот более бедным — `vendorAtomicData.ts` сносит папку целиком и не сверяет версии.
105
+ - **Проверяйте версию**: `vendor/atomic-mcp-data/manifest.json` содержит версию `@salutejs/sdds-finai`, из которой собран текущий снэпшот (сейчас `0.355.0`, установленный в монорепо пакет — `0.351.0`). Прогон на более старом чекауте plasma перезапишет снэпшот более бедным — `vendorAtomicData.ts` сносит папку целиком и не сверяет версии.
96
106
 
97
107
  ## Курированные данные каталога (description/category/keywords)
98
108