@retailcrm/embed-ui 0.9.23-alpha.1 → 0.9.23-alpha.3

package/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 
 
+## [0.9.23-alpha.3](https://github.com/retailcrm/embed-ui/compare/v0.9.23-alpha.2...v0.9.23-alpha.3) (2026-05-23)
+
+### Features
+
+* Contexts MCP init support added ([ff151f4](https://github.com/retailcrm/embed-ui/commit/ff151f47f2cef4d3a8ab0812c481cc5d9ae5ccf9))
+* **v1-contexts:** MCP server for context profiles added ([9f5184b](https://github.com/retailcrm/embed-ui/commit/9f5184bb52e48e5165a12490089d761a4fd5a6cd))
+* **v1-endpoint:** Context profile links added ([996903f](https://github.com/retailcrm/embed-ui/commit/996903fcbea45bd6012bf3f2d2f84426c09f6756))
+## [0.9.23-alpha.2](https://github.com/retailcrm/embed-ui/compare/v0.9.23-alpha.1...v0.9.23-alpha.2) (2026-05-22)
 ## [0.9.23-alpha.1](https://github.com/retailcrm/embed-ui/compare/v0.9.22...v0.9.23-alpha.1) (2026-05-22)
 
 ### Features

package/README.md

@@ -60,7 +60,7 @@ npx @retailcrm/embed-ui init ./web --package-manager yarn
 - шаблон — создается стартовая конфигурация для страницы настроек и виджета `order/card:common.after`;
 - каталоги — создаются `endpoint`, `pages`, `widgets`, `shared`, `i18n` и `i18n/locales` внутри frontend-каталога;
 - `AGENTS.md` — создается или дополняется инструкциями корневого пакета и выбранных пакетов;
-- MCP — добавляется `.mcp.json` для `v1-endpoint`;
+- MCP — добавляется `.mcp.json` для выбранных пакетов с MCP (`v1-contexts` и `v1-endpoint`);
 - project-level client configs для Codex CLI, Cursor, Junie и VS Code — не создаются без `--mcp-client-configs`;
 - Git — в неинтерактивном режиме не инициализируется без `--git`, а в интерактивном режиме предлагается, если корень проекта не является Git-репозиторием;
 - существующие файлы не перезаписываются, а зависимости с потенциальным конфликтом не заменяются без явных force-флагов.
@@ -104,12 +104,20 @@ npx @retailcrm/embed-ui init ./web --force --no-install --no-template
 При `init` CLI добавляет общий раздел в `AGENTS.md`, а пакеты могут добавить свои инструкции. Сейчас это используют:
 
 - `@retailcrm/embed-ui-v1-components` — добавляет порядок чтения README, AI-документации и YAML-профилей компонентов.
+- `@retailcrm/embed-ui-v1-contexts` — добавляет инструкции по контекстам, actions, custom contexts и MCP-ресурсам.
 - `@retailcrm/embed-ui-v1-endpoint` — добавляет инструкции по целям виджетов и MCP-ресурсам.
 
-Для `v1-endpoint` также создается `.mcp.json` с сервером `retailcrm-embed-ui-v1-endpoint`. Этот файл рассчитан на
-Claude Code project scope и использует `${CLAUDE_PROJECT_DIR:-.}/node_modules/.bin/embed-ui-v1-endpoint-mcp`, чтобы
-сервер резолвился относительно открытого проекта. MCP отдает AI-friendly описания целей виджетов через ресурсы:
-
+Для `v1-contexts` и `v1-endpoint`, если эти пакеты выбраны для установки, также создается `.mcp.json` с серверами
+`retailcrm-embed-ui-v1-contexts` и `retailcrm-embed-ui-v1-endpoint`. Этот файл рассчитан на Claude Code project scope
+и использует `${CLAUDE_PROJECT_DIR:-.}/node_modules/.bin/...`, чтобы серверы резолвились относительно открытого проекта.
+MCP отдает AI-friendly описания через ресурсы:
+
+- `embed-ui-v1-contexts://contexts`;
+- `embed-ui-v1-contexts://contexts/<encoded-context>`;
+- `embed-ui-v1-contexts://actions`;
+- `embed-ui-v1-contexts://actions/<encoded-scope>`;
+- `embed-ui-v1-contexts://custom-contexts`;
+- `embed-ui-v1-contexts://custom-contexts/<encoded-entity>`;
 - `embed-ui-v1-endpoint://targets`;
 - `embed-ui-v1-endpoint://targets/<encoded-target>`.
 
@@ -123,7 +131,7 @@ npx @retailcrm/embed-ui init ./web --no-install --mcp-client-configs codex,curso
 Для Codex CLI создается `.codex/config.toml`. Codex подхватывает его только в trusted project, поэтому после генерации
 проект нужно открыть/перезапустить в Codex и доверить ему проект, если клиент спросит. User-level подключение через
 `codex mcp add` намеренно не выполняется автоматически: на одной машине могут быть проекты с разными версиями
-`@retailcrm/embed-ui-v1-endpoint`, а user-level серверы с одинаковыми MCP resource URI могут конфликтовать между собой.
+`@retailcrm/embed-ui*`, а user-level серверы с одинаковыми MCP resource URI могут конфликтовать между собой.
 Для Cursor и VS Code CLI генерирует project-level конфиги с `${workspaceFolder}/node_modules/.bin/...`; для Junie
 остается относительный `./node_modules/.bin/...`.
 

package/bin/embed-ui.mjs

@@ -253,7 +253,23 @@ const INSTALLABLE_PACKAGES = [
     id: "contexts",
     name: "@retailcrm/embed-ui-v1-contexts",
     section: "dependencies",
-    description: "Реактивные контексты RetailCRM JS API."
+    description: "Реактивные контексты RetailCRM JS API.",
+    hooks: [
+      {
+        type: "agents",
+        binName: "embed-ui-v1-contexts",
+        command: "init-agents",
+        failureMode: "advisory",
+        requiresMcp: true
+      },
+      {
+        type: "config",
+        binName: "embed-ui-v1-contexts",
+        command: "init-config",
+        failureMode: "advisory",
+        requiresMcp: true
+      }
+    ]
   },
   {
     id: "types",
@@ -1223,7 +1239,10 @@ const applyInitPreflight = (cwd, sourceRoot, packageManager, selectedPackages, v
   }
   analyzeTemplateFileSkips(cwd, sourceRoot, options, changes);
   if (hasEnabledMcpConfigHook(selectedPackages, options)) {
-    changes.preflight.push("v1-endpoint init-config: enabled");
+    const packageNames = selectedPackages.filter(
+      (selectedPackage) => selectedPackage.hooks?.some((hook) => hook.type === "config" && hook.requiresMcp) ?? false
+    ).map((selectedPackage) => selectedPackage.id).join(", ");
+    changes.preflight.push(`package MCP init-config: enabled for ${packageNames}`);
     if (options.mcpClientConfigs?.length) {
       changes.preflight.push(`MCP client configs requested: ${options.mcpClientConfigs.join(", ")}`);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@retailcrm/embed-ui",
   "type": "module",
-  "version": "0.9.23-alpha.1",
+  "version": "0.9.23-alpha.3",
   "description": "API and components for creating RetailCRM UI extensions",
   "repository": {
     "type": "git",
@@ -57,10 +57,10 @@
     "@omnicajs/symfony-router": "^1.0.0",
     "@omnicajs/vue-remote": "^0.2.24",
     "@remote-ui/rpc": "^1.4.5",
-    "@retailcrm/embed-ui-v1-components": "^0.9.23-alpha.1",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.23-alpha.1",
-    "@retailcrm/embed-ui-v1-endpoint": "^0.9.23-alpha.1",
-    "@retailcrm/embed-ui-v1-types": "^0.9.23-alpha.1",
+    "@retailcrm/embed-ui-v1-components": "^0.9.23-alpha.3",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.23-alpha.3",
+    "@retailcrm/embed-ui-v1-endpoint": "^0.9.23-alpha.3",
+    "@retailcrm/embed-ui-v1-types": "^0.9.23-alpha.3",
     "yargs": "^17.7.2"
   },
   "devDependencies": {
@@ -69,7 +69,7 @@
     "@modulify/git-toolkit": "^0.0.2",
     "@modulify/pkg": "^1.0.1",
     "@omnicajs/eslint-plugin-dependencies": "^0.0.2",
-    "@retailcrm/embed-ui-v1-testing": "^0.9.23-alpha.1",
+    "@retailcrm/embed-ui-v1-testing": "^0.9.23-alpha.3",
     "@types/git-semver-tags": "^7.0.0",
     "@types/node": "^22.19.2",
     "@types/semver": "^7.7.1",