@daisforge/ui-mcp 0.2.1 → 0.2.3

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
@@ -142,6 +142,40 @@ gh workflow run publish-mcp-server.yml -f bump=patch -f dry_run=false # реа
142
142
 
143
143
  Workflow объявлен и как `workflow_call` — задел на будущее, если релиз `ui-mcp` решат триггерить автоматически из `publish-npm.yml` вместо ручного запуска.
144
144
 
145
+ ### Зеркальный (white-label) пакет
146
+
147
+ Тем же прогоном публикуется второй, зеркальный пакет: тот же собранный `dist/` и тот же индекс, но под другим именем и с другим именем связанной библиотеки. Отдельного репозитория и отдельной ветки для этого нет — **исходники в `src/` про зеркало ничего не знают**.
148
+
149
+ Работает это так: `scripts/build-alias-package.mjs` копирует `dist/` и `data/component-index.json` во временный каталог **вне рабочего дерева** (`ALIAS_OUT_DIR`, по умолчанию системный tmp), прогоняет по ним таблицу текстовых замен, собирает свои `package.json` и `README.md`, и `npm publish` делается уже оттуда. Основной пакет при этом не меняется ни на байт.
150
+
151
+ Имена берутся из секретов репозитория — в коде их нет:
152
+
153
+ | Секрет | Что это |
154
+ | --- | --- |
155
+ | `ALT_MCP_PACKAGE_NAME` | имя зеркального npm-пакета |
156
+ | `ALT_LIB_PACKAGE_NAME` | имя связанной библиотеки — подставляется вместо `@daisforge/ui` |
157
+ | `ALT_NPM_TOKEN` | токен с правами publish в новый scope |
158
+
159
+ Локально зеркало собирается той же командой, что и в CI:
160
+
161
+ ```bash
162
+ npm run build --prefix packages/mcp-server # dist/ должен быть свежим
163
+ ALT_MCP_PACKAGE_NAME=@acme/ds-mcp ALT_LIB_PACKAGE_NAME=@acme/ds \
164
+ npm run mcp:alias:stage --prefix packages/mcp-server
165
+ ```
166
+
167
+ Путь к собранному зеркалу скрипт печатает последней строкой; переопределяется через `ALIAS_OUT_DIR`.
168
+
169
+ Что стоит знать, если придётся это чинить:
170
+
171
+ - **Staging обязан лежать вне рабочего дерева git.** `npm publish` ищет `.git` вверх от каталога пакета и, найдя, добавляет в манифест реестра поле `gitHead` с SHA текущего HEAD (`@npmcli/package-json/lib/normalize.js`). У основного пакета это поле есть — `npm view @daisforge/ui-mcp gitHead` его показывает. Одинаковый SHA у двух пакетов связал бы зеркало с основным намертво, поэтому скрипт сам проверяет, что каталог не внутри репозитория, и падает, если это не так. В тарболе `gitHead` не лежит — только в метаданных реестра, из-за чего `npm pack` эту утечку не покажет.
172
+ - **Порядок замен в `REPLACEMENTS` значим**: длинные токены идут первыми, иначе `@daisforge/ui-mcp` превратится в `<ALT_LIB>-mcp`. Список закрытый, но в конце сборки работает гард — рекурсивный греп staging на `/dais/i`. Появится в артефактах новая форма бренда (новое имя стори-папки, новая ссылка в комментарии) — сборка зеркала упадёт с указанием файла и строки, и в таблицу нужно добавить правило. Молча бренд не утечёт.
173
+ - **Зеркало публикуется первым, основной пакет вторым.** Если падает зеркало (новый scope, отдельный токен, своя история версий), job обрывается до публикации `@daisforge/ui-mcp` и до `git push` — ничего не опубликовано, ничего не запушено, повтор чистый.
174
+ - **Версия у зеркала та же**, что у основного пакета (лок-степ). Если истории версий в двух scope разойдутся, `npm publish` упадёт с `EPUBLISHCONFLICT`.
175
+ - **`dist/indexer` и `dist/validate` в зеркало не едут**: они нужны только внутри монорепо и тянут `ts-morph` (devDependency) — из тарбола запуститься не могут в принципе. Из `dist` также вычищаются `.map` (ссылаются на `../src/*`, которого в тарболе нет).
176
+ - **`@salutejs/*` не переименовывается** — это реальные импорты атомов в vendor-примерах, потребителю они нужны рабочими.
177
+ - Если секреты не заданы или `publish_alias=false`, шаги зеркала пропускаются с warning — обычный релиз `@daisforge/ui-mcp` от этого не страдает.
178
+
145
179
  ## Известные ограничения v1
146
180
 
147
181
  - **Иконки, токены, миксины, утилиты не проиндексированы** — сознательная граница v1 (см. план). Следующий шаг.
@@ -1,5 +1,5 @@
1
1
  {
2
- "generatedAt": "2026-08-21T16:58:08.000Z",
2
+ "generatedAt": "2026-08-21T23:35:11.149Z",
3
3
  "libVersion": "1.14.1",
4
4
  "components": {
5
5
  "Accordion": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@daisforge/ui-mcp",
3
- "version": "0.2.1",
3
+ "version": "0.2.3",
4
4
  "description": "MCP server for @daisforge/ui — component discovery, props and examples for coding agents",
5
5
  "type": "module",
6
6
  "bin": {
@@ -18,6 +18,7 @@
18
18
  "mcp:build-index": "node ../../generators/meta-info/generate-meta.js && node ./dist/indexer/buildIndex.js",
19
19
  "mcp:vendor-atomic": "node ./dist/indexer/vendorAtomicData.js",
20
20
  "mcp:start": "node ./dist/server.js",
21
+ "mcp:alias:stage": "node ./scripts/build-alias-package.mjs",
21
22
  "mcp:ab": "node ./ab/run.mjs && node ./ab/score.mjs",
22
23
  "mcp:ab:consumer": "node ./ab/prepare-consumer.mjs",
23
24
  "mcp:ab:drift": "node ./ab/drift.mjs",