@daisforge/ui-mcp 0.1.1 → 0.2.1
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.
- package/README.md +13 -3
- package/data/component-index.json +31207 -19241
- package/dist/indexer/buildIndex.js +49 -2
- package/dist/indexer/buildIndex.js.map +1 -1
- package/dist/indexer/collectUsageExamples.js +10 -2
- package/dist/indexer/collectUsageExamples.js.map +1 -1
- package/dist/indexer/indexFeatures.js +1 -13
- package/dist/indexer/indexFeatures.js.map +1 -1
- package/dist/indexer/indexTypes.js +2 -4
- package/dist/indexer/indexTypes.js.map +1 -1
- package/dist/indexer/loadMeta.js +49 -0
- package/dist/indexer/loadMeta.js.map +1 -0
- package/dist/indexer/mergeMeta.js +1 -13
- package/dist/indexer/mergeMeta.js.map +1 -1
- package/dist/indexer/parseComponent.js +162 -12
- package/dist/indexer/parseComponent.js.map +1 -1
- package/dist/indexer/resolveImportPath.js +101 -0
- package/dist/indexer/resolveImportPath.js.map +1 -1
- package/dist/indexer/synthesizeExample.js +10 -0
- package/dist/indexer/synthesizeExample.js.map +1 -1
- package/dist/indexer/vendorExamples.js +7 -2
- package/dist/indexer/vendorExamples.js.map +1 -1
- package/dist/resolveIndex.js +61 -2
- package/dist/resolveIndex.js.map +1 -1
- package/dist/server.js +1 -1
- package/dist/server.js.map +1 -1
- package/dist/tools/getType.js +105 -2
- package/dist/tools/getType.js.map +1 -1
- package/dist/tools/searchComponents.js +96 -12
- package/dist/tools/searchComponents.js.map +1 -1
- package/dist/types.js.map +1 -1
- package/dist/validate/checkCompleteness.js +65 -0
- package/dist/validate/checkCompleteness.js.map +1 -0
- package/dist/validate/validateIndex.js +9 -0
- package/dist/validate/validateIndex.js.map +1 -1
- package/package.json +4 -3
package/README.md
CHANGED
|
@@ -67,11 +67,21 @@ 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` (мы внутри монорепо), сервер читает свежесобранный локальный индекс.
|
|
73
|
-
2. **installed** — версия `@daisforge/ui`, установленная у потребителя, уже содержит `mcp-data/component-index.json`.
|
|
74
|
-
3. **bundled** — запасной индекс, вшитый в сам `@daisforge/ui-mcp`. Нужен для версий `@daisforge/ui`, опубликованных до появления mcp-data
|
|
83
|
+
2. **installed** — версия `@daisforge/ui`, установленная у потребителя, уже содержит `mcp-data/component-index.json`. Побеждает, **только если этот индекс не деградировал**: пустой `features` или отсутствие `guides.installation` означают, что при сборке не сгенерировали курированную мету, — тогда сервер откатывается на `bundled` и объясняет это в `dataVersionNotice`. Так вышло с `@daisforge/ui@1.14.0` — первой версией, куда индекс вообще начал класться: релизный шаг собирал его мимо `npm run meta`, и обновление библиотеки до неё **ухудшало** данные MCP (до 1.14.0 работал полноценный `bundled`, с 1.14.0 включался заведомо худший `installed`).
|
|
84
|
+
3. **bundled** — запасной индекс, вшитый в сам `@daisforge/ui-mcp`. Нужен для версий `@daisforge/ui`, опубликованных до появления mcp-data, для деградировавшего `installed` (см. выше) и для случая, когда библиотека вообще не установлена. В этом случае в ответах присутствует `dataVersionNotice`/`libNotInstalled`.
|
|
75
85
|
|
|
76
86
|
Всё работает полностью оффлайн — сервер никогда не обращается по сети.
|
|
77
87
|
|
|
@@ -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.
|
|
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
|
|