@daisforge/ui-mcp 0.2.0 → 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 CHANGED
@@ -80,8 +80,8 @@ npm run mcp:build-index
80
80
  ## Резолв индекса — три уровня
81
81
 
82
82
  1. **workspace** — если рядом физически лежит `packages/ui-kit` (мы внутри монорепо), сервер читает свежесобранный локальный индекс.
83
- 2. **installed** — версия `@daisforge/ui`, установленная у потребителя, уже содержит `mcp-data/component-index.json`.
84
- 3. **bundled** — запасной индекс, вшитый в сам `@daisforge/ui-mcp`. Нужен для версий `@daisforge/ui`, опубликованных до появления mcp-data (то есть всех текущих!), и для случая, когда библиотека вообще не установлена. В этом случае в ответах присутствует `dataVersionNotice`/`libNotInstalled`.
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`.
85
85
 
86
86
  Всё работает полностью оффлайн — сервер никогда не обращается по сети.
87
87
 
@@ -1,6 +1,6 @@
1
1
  {
2
- "generatedAt": "2026-08-21T16:20:51.632Z",
3
- "libVersion": "1.14.0",
2
+ "generatedAt": "2026-08-21T16:58:08.000Z",
3
+ "libVersion": "1.14.1",
4
4
  "components": {
5
5
  "Accordion": {
6
6
  "name": "Accordion",
@@ -50,6 +50,20 @@ function getInstalledLibVersion() {
50
50
  return undefined;
51
51
  return readJson(pkgPath)?.version;
52
52
  }
53
+ /**
54
+ * Индекс, у которого обвалился источник данных, а не просто «старая версия».
55
+ * Признаки бинарные и не зависят от размера каталога: `features` пустой либо
56
+ * нет `guides.installation`. И то, и другое приходит ТОЛЬКО из курированной
57
+ * меты, которая лежит в .gitignore — если её не сгенерировали перед сборкой,
58
+ * индекс собирается молча и без них (см. assertMetaAvailable).
59
+ *
60
+ * Проверять здесь пороги из checkCompleteness нельзя: они откалиброваны под
61
+ * текущий каталог, а установленная у потребителя библиотека может быть
62
+ * заметно старее и легитимно беднее. Обвал источника — другое.
63
+ */
64
+ function isDegradedIndex(index) {
65
+ return index.features.length === 0 || !index.guides?.installation;
66
+ }
53
67
  function buildDataVersionNotice(libNotInstalled, versionMismatch, libVersion, installedLibVersion) {
54
68
  if (libNotInstalled) {
55
69
  return `@daisforge/ui не установлен в этом проекте. Данные MCP соответствуют версии ${libVersion} — прочитайте ресурс daisforge-ui://catalog/installation-guide, чтобы подключить библиотеку.`;
@@ -82,6 +96,31 @@ export function resolveIndex() {
82
96
  const installedIndexPath = resolveFromConsumer('@daisforge/ui/mcp-data/component-index.json');
83
97
  if (installedIndexPath) {
84
98
  const index = readJson(installedIndexPath);
99
+ if (index && !isDegradedIndex(index)) {
100
+ return { index, source: 'installed', installedLibVersion };
101
+ }
102
+ // Индекс внутри библиотеки есть, но неполный. Так уехал @daisforge/ui@1.14.0
103
+ // — первая версия, куда индекс вообще начал класться: релизный шаг собирал
104
+ // его мимо `npm run meta`, и наружу отправился каталог без features, без
105
+ // guides и без full-code примеров. Раньше такой индекс выигрывал у
106
+ // запасного безусловно (проверялось только «файл есть и парсится»), то
107
+ // есть обновление библиотеки УХУДШАЛО данные MCP: до 1.14.0 работал
108
+ // bundled, с 1.14.0 включился заведомо худший installed.
109
+ //
110
+ // Откатываемся на запасной, только если он сам не деградировал — иначе
111
+ // менять шило на мыло, теряя совпадение по версии библиотеки.
112
+ const fallback = readJson(BUNDLED_INDEX_PATH);
113
+ if (index && fallback && !isDegradedIndex(fallback)) {
114
+ return {
115
+ index: fallback,
116
+ source: 'bundled',
117
+ installedLibVersion,
118
+ dataVersionNotice: `Индекс внутри установленного @daisforge/ui@${installedLibVersion} неполный ` +
119
+ '(нет features и гайда по установке — он собран до исправления релизного пайплайна), ' +
120
+ `поэтому используется запасной индекс версии ${fallback.libVersion} из @daisforge/ui-mcp. ` +
121
+ 'Возможны расхождения в пропсах, если версии не совпадают — обновите @daisforge/ui.',
122
+ };
123
+ }
85
124
  if (index) {
86
125
  return { index, source: 'installed', installedLibVersion };
87
126
  }
@@ -1 +1 @@
1
- {"version":3,"file":"resolveIndex.js","sourceRoot":"","sources":["../src/resolveIndex.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"resolveIndex.js","sourceRoot":"","sources":["../src/resolveIndex.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@daisforge/ui-mcp",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "MCP server for @daisforge/ui — component discovery, props and examples for coding agents",
5
5
  "type": "module",
6
6
  "bin": {