@retailcrm/embed-ui 0.9.22-alpha.4 → 0.9.22-alpha.7

package/CHANGELOG.md

@@ -1,6 +1,27 @@
 # Changelog
 
 
+## [0.9.22-alpha.7](https://github.com/retailcrm/embed-ui/compare/v0.9.22-alpha.6...v0.9.22-alpha.7) (2026-05-20)
+
+### Bug Fixes
+
+* Package manifests normalized for npm publish ([c612b50](https://github.com/retailcrm/embed-ui/commit/c612b5040ba79bab6c88360554b8f156b48e3721))
+## [0.9.22-alpha.6](https://github.com/retailcrm/embed-ui/compare/v0.9.22-alpha.5...v0.9.22-alpha.6) (2026-05-20)
+
+### Features
+
+* MCP client config selection added ([e46fccd](https://github.com/retailcrm/embed-ui/commit/e46fccde382e6d0af2550932e00d41f8a3bcc1af))
+
+### Bug Fixes
+
+* **v1-endpoint:** MCP startup probes handled ([9695b77](https://github.com/retailcrm/embed-ui/commit/9695b779de22fdd73c977546e592e327db4f5f1a))
+* **v1-endpoint:** Project-level MCP config generated ([16ff7a2](https://github.com/retailcrm/embed-ui/commit/16ff7a2a0321ba01c186da0f6ad3664930bd1de4))
+## [0.9.22-alpha.5](https://github.com/retailcrm/embed-ui/compare/v0.9.22-alpha.4...v0.9.22-alpha.5) (2026-05-19)
+
+### Features
+
+* Embed UI init flow improved ([50357d6](https://github.com/retailcrm/embed-ui/commit/50357d647d5288c9794e46ef91a36d2da6620101))
+* Embed UI init MCP setup completed ([749c87a](https://github.com/retailcrm/embed-ui/commit/749c87a64bab67b6ed72aed7391ccf24403943ff))
 ## [0.9.22-alpha.4](https://github.com/retailcrm/embed-ui/compare/v0.9.22-alpha.3...v0.9.22-alpha.4) (2026-05-19)
 
 ### Bug Fixes

package/README.md

@@ -38,9 +38,11 @@ npx @retailcrm/embed-ui --help
 - добавляет `package.json`, если его еще нет;
 - добавляет зависимости `@retailcrm/embed-ui*`, `vue`, `pinia`, `vue-i18n` и dev-зависимости для Vite, TypeScript и ESLint;
 - создает `tsconfig.json`, `vite.config.ts`, `eslint.config.js`, `env.d.ts`;
+- создает или дополняет `.gitignore` типовыми правилами для `node_modules`, `dist`, `coverage`, `.env` и логов;
 - создает стартовые файлы во frontend-каталоге: endpoint worker, страницу настроек, виджет заказа, i18n JSON-сообщения;
 - добавляет `extensionrc.json` и `scripts/publish-extension.mjs`;
-- добавляет `AGENTS.md` и MCP-настройки пакетов, если они не отключены флагами.
+- добавляет `AGENTS.md` и MCP-настройки пакетов, если они не отключены флагами;
+- может инициализировать Git-репозиторий, если включить `--git` или выбрать это действие в интерактивном режиме.
 
 ```bash
 npx @retailcrm/embed-ui init ./web --package-manager yarn
@@ -52,13 +54,15 @@ npx @retailcrm/embed-ui init ./web --package-manager yarn
 - frontend-каталог — позиционный аргумент команды, а если его нет, то `./src` для нового проекта или `./web`, если `./src` уже существует;
 - версия пакетов — версия запущенного CLI;
 - package manager — определяется по единственному lock-файлу в корне проекта, в интерактивном терминале запрашивается у пользователя, в неинтерактивном режиме используется `npm`;
+- интерактивный выбор package manager показывает только найденные в `PATH` варианты, а явно выбранный недоступный manager останавливает `init` до записи файлов;
 - пакеты — `@retailcrm/embed-ui`, `v1-components`, `v1-contexts`, `v1-types` и `v1-endpoint`;
 - установка зависимостей — запускается автоматически после изменения `package.json`;
 - шаблон — создается стартовая конфигурация для страницы настроек и виджета `order/card:common.after`;
 - каталоги — создаются `endpoint`, `pages`, `widgets`, `shared`, `i18n` и `i18n/locales` внутри frontend-каталога;
 - `AGENTS.md` — создается или дополняется инструкциями корневого пакета и выбранных пакетов;
 - MCP — добавляется `.mcp.json` для `v1-endpoint`;
-- client configs для Cursor, Junie и VS Code — не создаются без `--mcp-client-configs`;
+- project-level client configs для Codex CLI, Cursor, Junie и VS Code — не создаются без `--mcp-client-configs`;
+- Git — в неинтерактивном режиме не инициализируется без `--git`, а в интерактивном режиме предлагается, если корень проекта не является Git-репозиторием;
 - существующие файлы не перезаписываются, а зависимости с потенциальным конфликтом не заменяются без явных force-флагов.
 
 По умолчанию команда использует текущий рабочий каталог как корень проекта. Его можно задать явно:
@@ -85,7 +89,8 @@ npx @retailcrm/embed-ui init ./web --cwd ./my-project --package-manager npm
 - `--no-template` — не создавать стартовые Vue-файлы и `extensionrc.json`.
 - `--no-agents` — не создавать и не дополнять `AGENTS.md`.
 - `--no-mcp` — не добавлять MCP-настройки пакетов.
-- `--mcp-client-configs cursor,junie,vscode` — дополнительно создать project-level конфиги поддерживаемых AI-клиентов.
+- `--mcp-client-configs codex,cursor,junie,vscode` — дополнительно создать project-level конфиги поддерживаемых AI-клиентов.
+- `--git` — выполнить `git init` в корне проекта, если каталог еще не является Git-репозиторием.
 
 `--force` включает силовой режим для управляемых частей, но учитывает флаги `--no-*`. Например, можно обновить только
 агентские инструкции и MCP-настройки без перегенерации стартовых файлов:
@@ -101,8 +106,9 @@ npx @retailcrm/embed-ui init ./web --force --no-install --no-template
 - `@retailcrm/embed-ui-v1-components` — добавляет порядок чтения README, AI-документации и YAML-профилей компонентов.
 - `@retailcrm/embed-ui-v1-endpoint` — добавляет инструкции по целям виджетов и MCP-ресурсам.
 
-Для `v1-endpoint` также создается `.mcp.json` с сервером `retailcrm-embed-ui-v1-endpoint`. Он отдает AI-friendly
-описания целей виджетов через ресурсы:
+Для `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 описания целей виджетов через ресурсы:
 
 - `embed-ui-v1-endpoint://targets`;
 - `embed-ui-v1-endpoint://targets/<encoded-target>`.
@@ -111,9 +117,16 @@ npx @retailcrm/embed-ui init ./web --force --no-install --no-template
 Чтобы добавить только поддерживаемые project-level конфиги, укажите:
 
 ```bash
-npx @retailcrm/embed-ui init ./web --no-install --mcp-client-configs cursor,junie,vscode
+npx @retailcrm/embed-ui init ./web --no-install --mcp-client-configs codex,cursor,junie,vscode
 ```
 
+Для Codex CLI создается `.codex/config.toml`. Codex подхватывает его только в trusted project, поэтому после генерации
+проект нужно открыть/перезапустить в Codex и доверить ему проект, если клиент спросит. User-level подключение через
+`codex mcp add` намеренно не выполняется автоматически: на одной машине могут быть проекты с разными версиями
+`@retailcrm/embed-ui-v1-endpoint`, а user-level серверы с одинаковыми MCP resource URI могут конфликтовать между собой.
+Для Cursor и VS Code CLI генерирует project-level конфиги с `${workspaceFolder}/node_modules/.bin/...`; для Junie
+остается относительный `./node_modules/.bin/...`.
+
 Повторный запуск без `--force` не дублирует управляемые секции и записи MCP. При `--force` обновляются только записи
 этого пакета, ручные серверы и соседние разделы не удаляются.
 

package/bin/embed-ui.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createInterface } from "node:readline/promises";
-import { execFileSync } from "node:child_process";
+import { execFileSync, spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import fs from "node:fs";
 import path from "node:path";
@@ -34,7 +34,8 @@ Options:
       --fix-sections      Move init dependencies to expected package.json sections
       --no-agents         Do not create or update AGENTS.md in init mode
       --no-mcp            Do not add package MCP instructions in init mode
-      --mcp-client-configs Comma-separated MCP client configs to create (cursor,junie,vscode)
+      --mcp-client-configs Comma-separated project-level MCP client configs to create (codex,cursor,junie,vscode)
+      --git               Initialize Git repository in init mode when cwd is not a Git work tree
   -h, --help              Show this help
 
 Examples:
@@ -114,6 +115,10 @@ const parseInitArgs = (argv) => {
     type: "string",
     coerce: parsePackageList,
     describe: "Comma-separated MCP client config ids"
+  }).option("git", {
+    type: "boolean",
+    default: false,
+    describe: "Initialize Git repository when cwd is not a Git work tree"
   }).parseSync();
   if (parsed.help || parsed.h) {
     console.log(HELP_TEXT);
@@ -156,7 +161,8 @@ const parseInitArgs = (argv) => {
     agentsOnly: parsed.agentsOnly,
     noMcp: !parsed.mcp,
     forceMcp: parsed.forceMcp,
-    mcpClientConfigs: parsed.mcpClientConfigs ?? null
+    mcpClientConfigs: parsed.mcpClientConfigs ?? null,
+    initGit: parsed.git
   };
 };
 const parseArgs = (argv) => {
@@ -610,13 +616,7 @@ const setDependency = (packageJson, section, name, range, changes, options = {})
     nextRange
   });
 };
-const resolveLocalBinPath = (cwd, binName) => {
-  const binPath = path.join(cwd, "node_modules", ".bin", process.platform === "win32" ? `${binName}.cmd` : binName);
-  return fs.existsSync(binPath) ? binPath : null;
-};
-const hasLocalPackage = (cwd, packageName) => fs.existsSync(path.join(cwd, "node_modules", packageName, "package.json"));
-const createPackageSpec = (packageName, version) => version && version !== "not used" ? `${packageName}@${version}` : packageName;
-const resolvePackageManagerVersion$1 = (packageManager) => {
+const resolvePackageManagerVersion = (packageManager) => {
   try {
     return execFileSync(packageManager, ["--version"], {
       encoding: "utf8",
@@ -626,6 +626,90 @@ const resolvePackageManagerVersion$1 = (packageManager) => {
     return null;
   }
 };
+const isPackageManagerAvailable = (packageManager) => resolvePackageManagerVersion(packageManager) !== null;
+const assertPackageManagerAvailable = (packageManager) => {
+  if (!isPackageManagerAvailable(packageManager)) {
+    throw new Error(
+      `Package manager "${packageManager}" was selected, but its binary was not found in PATH. Install ${packageManager} or choose another package manager.`
+    );
+  }
+};
+const SPINNER_FRAMES = ["-", "\\", "|", "/"];
+class CommandError extends Error {
+  stdout;
+  stderr;
+  constructor(command, exitCode, stdout, stderr) {
+    super(`Command failed${exitCode === null ? "" : ` with exit code ${exitCode}`}: ${command}`);
+    this.stdout = stdout;
+    this.stderr = stderr;
+  }
+}
+const createSpinner = (message) => {
+  if (!process.stderr.isTTY) {
+    return () => void 0;
+  }
+  let frameIndex = 0;
+  process.stderr.write(`${SPINNER_FRAMES[frameIndex]} ${message}`);
+  const timer = setInterval(() => {
+    frameIndex = (frameIndex + 1) % SPINNER_FRAMES.length;
+    process.stderr.write(`\r${SPINNER_FRAMES[frameIndex]} ${message}`);
+  }, 100);
+  return () => {
+    clearInterval(timer);
+  };
+};
+const finishSpinner = (message, status) => {
+  if (process.stderr.isTTY) {
+    process.stderr.write(`\r${status} ${message}
+`);
+  }
+};
+const runCommandWithTerminalStatus = async (command, args, options, message) => {
+  const stopSpinner = createSpinner(message);
+  const displayCommand = [command, ...args].join(" ");
+  let stdoutResult = "";
+  let stderrResult = "";
+  try {
+    await new Promise((resolve, reject) => {
+      const child = spawn(command, args, {
+        ...options,
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+      const stdout = [];
+      const stderr = [];
+      child.stdout.on("data", (chunk) => stdout.push(chunk));
+      child.stderr.on("data", (chunk) => stderr.push(chunk));
+      child.on("error", reject);
+      child.on("close", (exitCode) => {
+        const stdoutBuffer = Buffer.concat(stdout);
+        const stderrBuffer = Buffer.concat(stderr);
+        stdoutResult = stdoutBuffer.toString("utf8");
+        stderrResult = stderrBuffer.toString("utf8");
+        if (exitCode === 0) {
+          resolve();
+          return;
+        }
+        reject(new CommandError(displayCommand, exitCode, stdoutBuffer, stderrBuffer));
+      });
+    });
+    finishSpinner(message, "OK");
+    return {
+      stdout: stdoutResult,
+      stderr: stderrResult
+    };
+  } catch (error) {
+    finishSpinner(message, "FAIL");
+    throw error;
+  } finally {
+    stopSpinner();
+  }
+};
+const resolveLocalBinPath = (cwd, binName) => {
+  const binPath = path.join(cwd, "node_modules", ".bin", process.platform === "win32" ? `${binName}.cmd` : binName);
+  return fs.existsSync(binPath) ? binPath : null;
+};
+const hasLocalPackage = (cwd, packageName) => fs.existsSync(path.join(cwd, "node_modules", packageName, "package.json"));
+const createPackageSpec = (packageName, version) => version && version !== "not used" ? `${packageName}@${version}` : packageName;
 const resolveMajorVersion = (version) => {
   const major = version?.match(/^\d+/u)?.[0];
   return major ? Number(major) : null;
@@ -677,7 +761,7 @@ const resolveDownloadCommand = (packageName, binName, packageManager, args, pack
     source: "transient"
   };
 };
-const resolvePackageHookCommand = (cwd, packageName, binName, packageManager, args, packageVersion = null, versionResolver = resolvePackageManagerVersion$1) => {
+const resolvePackageHookCommand = (cwd, packageName, binName, packageManager, args, packageVersion = null, versionResolver = resolvePackageManagerVersion) => {
   const localBinPath = resolveLocalBinPath(cwd, binName);
   if (localBinPath) {
     return {
@@ -709,7 +793,15 @@ const getExecErrorMessage = (error) => {
   }
   return String(error);
 };
-const runPackageHookCommand = (cwd, packageName, binName, packageManager, args, failureMode, options, changes) => {
+const appendMcpHookNotices = (output, changes) => {
+  for (const line of output.split(/\r?\n/u)) {
+    const trimmedLine = line.trim();
+    if (trimmedLine.startsWith("MCP: ")) {
+      changes.mcp.push(trimmedLine.slice("MCP: ".length));
+    }
+  }
+};
+const runPackageHookCommand = async (cwd, packageName, binName, packageManager, args, failureMode, options, changes) => {
   const command = resolvePackageHookCommand(
     cwd,
     packageName,
@@ -723,10 +815,13 @@ const runPackageHookCommand = (cwd, packageName, binName, packageManager, args,
     return;
   }
   try {
-    execFileSync(command.command, command.args, {
-      cwd,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
+    const result = await runCommandWithTerminalStatus(
+      command.command,
+      command.args,
+      { cwd },
+      `Running ${packageName} ${args[0]}`
+    );
+    appendMcpHookNotices(result.stdout, changes);
   } catch (error) {
     if (command.source === "transient" && failureMode === "advisory") {
       changes.warnings.push(`Package hook ${command.display} was skipped: ${getExecErrorMessage(error)}`);
@@ -771,12 +866,12 @@ const updateRootAgents = (cwd, options, changes) => {
   }
   changes.agents.push(`update ${agentsPath}`);
 };
-const runInitAgentsHook = (packageName, binName, cwd, packageManager, failureMode, options, changes) => {
+const runInitAgentsHook = async (packageName, binName, cwd, packageManager, failureMode, options, changes) => {
   const args = ["init-agents", cwd];
   if (options.force || options.forceAgents) {
     args.push("--force");
   }
-  runPackageHookCommand(
+  await runPackageHookCommand(
     cwd,
     packageName,
     binName,
@@ -787,7 +882,7 @@ const runInitAgentsHook = (packageName, binName, cwd, packageManager, failureMod
     changes
   );
 };
-const applyInitAgents = (cwd, selectedPackages, packageManager, options, changes) => {
+const applyInitAgents = async (cwd, selectedPackages, packageManager, options, changes) => {
   if (options.noAgents) {
     return;
   }
@@ -801,7 +896,7 @@ const applyInitAgents = (cwd, selectedPackages, packageManager, options, changes
         changes.warnings.push(`Skipping ${selectedPackage.id} ${hook.command} because it currently includes MCP instructions`);
         continue;
       }
-      runInitAgentsHook(
+      await runInitAgentsHook(
         selectedPackage.name,
         hook.binName,
         cwd,
@@ -813,7 +908,7 @@ const applyInitAgents = (cwd, selectedPackages, packageManager, options, changes
     }
   }
 };
-const applyInitPackageConfigHooks = (cwd, selectedPackages, packageManager, options, changes) => {
+const applyInitPackageConfigHooks = async (cwd, selectedPackages, packageManager, options, changes) => {
   for (const selectedPackage of selectedPackages) {
     for (const hook of selectedPackage.hooks ?? []) {
       if (hook.type !== "config") {
@@ -829,7 +924,7 @@ const applyInitPackageConfigHooks = (cwd, selectedPackages, packageManager, opti
       if (hook.requiresMcp && options.mcpClientConfigs?.length) {
         args.push("--mcp-client-configs", options.mcpClientConfigs.join(","));
       }
-      runPackageHookCommand(
+      await runPackageHookCommand(
         cwd,
         selectedPackage.name,
         hook.binName,
@@ -912,6 +1007,35 @@ const describePathState = (cwd, relativePath) => {
   }
   return `${relativePath}: found`;
 };
+const isGitWorkTree$2 = (cwd) => {
+  try {
+    execFileSync("git", ["rev-parse", "--is-inside-work-tree"], {
+      cwd,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    return true;
+  } catch {
+    return false;
+  }
+};
+const analyzeGitDirectory = (cwd, options, changes) => {
+  const gitPath = path.join(cwd, ".git");
+  if (!fs.existsSync(gitPath)) {
+    if (options.initGit) {
+      changes.preflight.push("git: missing; git init enabled");
+    }
+    return;
+  }
+  if (isGitWorkTree$2(cwd)) {
+    return;
+  }
+  if (options.initGit) {
+    changes.preflight.push("git: invalid .git metadata; git init enabled");
+  } else {
+    changes.warnings.push(".git exists, but Git does not recognize this directory as a repository; initialize or repair Git metadata before relying on git context");
+  }
+};
 const readExistingPackageJson = (packageJsonPath, changes) => {
   if (!fs.existsSync(packageJsonPath)) {
     changes.preflight.push("package.json: missing; it will be created");
@@ -1082,6 +1206,7 @@ const applyInitPreflight = (cwd, sourceRoot, packageManager, selectedPackages, v
   if (!options.target && !options.srcDir && fs.existsSync(path.join(cwd, "src")) && path.basename(sourceRoot) === "web") {
     changes.warnings.push("src/ already exists; generated frontend source root resolved to web/");
   }
+  analyzeGitDirectory(cwd, options, changes);
   changes.preflight.push(describePathState(cwd, "src"));
   changes.preflight.push(describePathState(cwd, "web"));
   if (options.noConfigs) {
@@ -2202,6 +2327,7 @@ const createInitChanges = () => ({
   files: [],
   agents: [],
   mcp: [],
+  git: [],
   hooks: [],
   install: null,
   skipped: [],
@@ -2252,7 +2378,8 @@ const printInitReport = (cwd, sourceRoot, version, packageManager, changes, opti
     console.log("");
     console.log("files");
     for (const filePath of changes.files) {
-      console.log(`  create ${filePath}`);
+      const hasAction = /^(create|update)\s/u.test(filePath);
+      console.log(`  ${hasAction ? filePath : `create ${filePath}`}`);
     }
   }
   if (changes.agents.length > 0) {
@@ -2276,6 +2403,13 @@ const printInitReport = (cwd, sourceRoot, version, packageManager, changes, opti
       console.log(`  ${options.dryRun ? "would run" : "ran"} ${hook}`);
     }
   }
+  if (changes.git.length > 0) {
+    console.log("");
+    console.log("git");
+    for (const gitChange of changes.git) {
+      console.log(`  ${gitChange}`);
+    }
+  }
   if (changes.install) {
     console.log("");
     console.log("install");
@@ -2308,9 +2442,10 @@ const printInitSummary = (cwd, sourceRoot, version, packageManager, changes) =>
   const summary = [
     changes.packageJson.length ? `package.json updated (${changes.packageJson.length} change(s))` : null,
     changes.directories.length ? `directories created: ${changes.directories.length}` : null,
-    changes.files.length ? `files created: ${changes.files.length}` : null,
+    changes.files.length ? `files changed: ${changes.files.length}` : null,
     changes.agents.length ? "AGENTS.md updated" : null,
     changes.mcp.length ? "MCP config updated" : null,
+    changes.git.length ? `git: ${changes.git.join(", ")}` : null,
     changes.hooks.length ? `package hooks ran: ${changes.hooks.length}` : null,
     changes.install ? `install: ${changes.install}` : null
   ].filter((item) => typeof item === "string");
@@ -4372,6 +4507,7 @@ const INIT_ACTION_LABELS = {
   template: "Создать стартовый шаблон",
   agents: "Обновить AGENTS.md",
   mcp: "Добавить MCP-настройки",
+  git: "Инициализировать Git",
   install: "Запустить установку зависимостей"
 };
 const INIT_ACTION_DESCRIPTIONS = {
@@ -4379,8 +4515,33 @@ const INIT_ACTION_DESCRIPTIONS = {
   template: "Vue-точка входа, страница настроек, виджет заказа, i18n и publish script",
   agents: "Общие и пакетные инструкции для AI-агентов",
   mcp: ".mcp.json и MCP-инструкции пакетов",
+  git: "git init в каталоге проекта, если Git еще не настроен",
   install: "Запуск выбранного package manager после изменения package.json"
 };
+const MCP_CLIENT_CONFIG_LABELS = {
+  codex: "Codex CLI",
+  cursor: "Cursor",
+  junie: "Junie",
+  vscode: "VS Code"
+};
+const MCP_CLIENT_CONFIG_DESCRIPTIONS = {
+  codex: ".codex/config.toml for trusted Codex projects",
+  cursor: ".cursor/mcp.json with ${workspaceFolder}",
+  junie: ".junie/mcp/mcp.json",
+  vscode: ".vscode/mcp.json with ${workspaceFolder}"
+};
+const MCP_CLIENT_CONFIGS = Object.keys(MCP_CLIENT_CONFIG_LABELS);
+const isGitWorkTree$1 = (cwd) => {
+  try {
+    execFileSync("git", ["rev-parse", "--is-inside-work-tree"], {
+      cwd,
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    return true;
+  } catch {
+    return false;
+  }
+};
 const resolveDefaultSourceRoot = (cwd, options) => {
   if (options.srcDir) {
     return options.srcDir;
@@ -4425,6 +4586,9 @@ const resolveAvailableActions = (options) => {
   if (!options.noMcp) {
     actions.push("mcp");
   }
+  if (!options.agentsOnly && !isGitWorkTree$1(options.cwd)) {
+    actions.push("git");
+  }
   if (!options.agentsOnly && !options.noInstall) {
     actions.push("install");
   }
@@ -4436,6 +4600,7 @@ const applyPromptedActions = (options, selectedActions) => {
   options.noTemplate = options.noTemplate || !selectedActionSet.has("template");
   options.noAgents = options.noAgents || !selectedActionSet.has("agents");
   options.noMcp = options.noMcp || !selectedActionSet.has("mcp");
+  options.initGit = options.initGit || selectedActionSet.has("git");
   options.noInstall = options.noInstall || !selectedActionSet.has("install");
 };
 const resolvePromptedActions = async (options) => {
@@ -4458,12 +4623,32 @@ const resolvePromptedPackageManager = async (detectedPackageManager, explicitPac
     return explicitPackageManager;
   }
   const defaultPackageManager = detectedPackageManager ?? "npm";
+  const availablePackageManagers = PACKAGE_MANAGERS.filter(isPackageManagerAvailable);
+  if (availablePackageManagers.length === 0) {
+    throw new Error("No supported package manager binary was found in PATH. Install npm, yarn, pnpm, or bun and rerun init.");
+  }
   return select({
     message: "Package manager",
-    default: defaultPackageManager,
+    default: availablePackageManagers.includes(defaultPackageManager) ? defaultPackageManager : availablePackageManagers[0],
     choices: PACKAGE_MANAGERS.map((packageManager) => ({
       name: packageManager,
-      value: packageManager
+      value: packageManager,
+      description: isPackageManagerAvailable(packageManager) ? "found in PATH" : "not found in PATH",
+      disabled: isPackageManagerAvailable(packageManager) ? false : "not found in PATH"
+    }))
+  });
+};
+const resolvePromptedMcpClientConfigs = async (options) => {
+  if (options.noMcp || options.mcpClientConfigs) {
+    return options.mcpClientConfigs;
+  }
+  return checkbox({
+    message: "MCP client configs",
+    choices: MCP_CLIENT_CONFIGS.map((clientConfig) => ({
+      name: MCP_CLIENT_CONFIG_LABELS[clientConfig],
+      value: clientConfig,
+      checked: false,
+      description: MCP_CLIENT_CONFIG_DESCRIPTIONS[clientConfig]
     }))
   });
 };
@@ -4491,12 +4676,56 @@ const resolveInteractiveInitOptions = async (cwd, options, detectedPackageManage
   }
   const selectedActions = await resolvePromptedActions(nextOptions);
   applyPromptedActions(nextOptions, selectedActions);
+  nextOptions.mcpClientConfigs = await resolvePromptedMcpClientConfigs(nextOptions);
   nextOptions.packageManager = await resolvePromptedPackageManager(
     detectedPackageManager,
     nextOptions.packageManager
   );
   return nextOptions;
 };
+const GITIGNORE_SECTION_HEADER = "# RetailCRM embed-ui init";
+const REQUIRED_GITIGNORE_ENTRIES = [
+  "node_modules/",
+  "dist/",
+  "coverage/",
+  ".env",
+  ".env.*",
+  "!.env.example",
+  "*.log",
+  "npm-debug.log*",
+  "yarn-debug.log*",
+  "yarn-error.log*",
+  "pnpm-debug.log*",
+  ".DS_Store"
+];
+const normalizeGitignoreLine = (line) => line.trim().replace(/\/$/u, "");
+const hasGitignoreEntry = (lines, entry) => {
+  const normalizedEntry = normalizeGitignoreLine(entry);
+  return lines.some((line) => normalizeGitignoreLine(line) === normalizedEntry);
+};
+const updateGitignore = (cwd, options, changes) => {
+  if (options.agentsOnly) {
+    return;
+  }
+  const gitignorePath = path.join(cwd, ".gitignore");
+  const fileExists = fs.existsSync(gitignorePath);
+  const currentContent = fileExists ? fs.readFileSync(gitignorePath, "utf8") : "";
+  const lines = currentContent.split(/\r?\n/u);
+  const missingEntries = REQUIRED_GITIGNORE_ENTRIES.filter((entry) => !hasGitignoreEntry(lines, entry));
+  if (missingEntries.length === 0) {
+    changes.skipped.push(`${gitignorePath} already contains required init entries`);
+    return;
+  }
+  const section = [
+    GITIGNORE_SECTION_HEADER,
+    ...missingEntries
+  ].join(DEFAULT_NEWLINE);
+  const nextContent = currentContent.trimEnd() ? `${currentContent.trimEnd()}${DEFAULT_NEWLINE}${DEFAULT_NEWLINE}${section}${DEFAULT_NEWLINE}` : `${section}${DEFAULT_NEWLINE}`;
+  if (!options.dryRun) {
+    fs.writeFileSync(gitignorePath, nextContent, "utf8");
+  }
+  changes.files.push(`${fileExists ? "update" : "create"} ${gitignorePath}`);
+};
 const DEFAULT_INIT_DIRS = ["endpoint", "pages", "widgets", "shared", "i18n"];
 const detectPackageManagerByLockfile = (cwd) => {
   const knownLockfiles = [
@@ -4508,16 +4737,6 @@ const detectPackageManagerByLockfile = (cwd) => {
   const lockfiles = knownLockfiles.filter(({ file }) => fs.existsSync(path.join(cwd, file)));
   return lockfiles.length === 1 ? lockfiles[0].packageManager : null;
 };
-const resolvePackageManagerVersion = (packageManager) => {
-  try {
-    return execFileSync(packageManager, ["--version"], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"]
-    }).trim();
-  } catch {
-    return null;
-  }
-};
 const resolvePackageManagerMajorVersion = (packageManager) => {
   const major = resolvePackageManagerVersion(packageManager)?.match(/^\d+/u)?.[0];
   return major ? Number(major) : null;
@@ -4565,6 +4784,16 @@ const resolveInitPackages = (tokens, extraTokens) => {
   }
   return packages;
 };
+const hasEnabledPackageHook = (selectedPackages, options) => selectedPackages.some((selectedPackage) => selectedPackage.hooks?.some((hook) => {
+  if (hook.type === "agents") {
+    return !options.noAgents && (!hook.requiresMcp || !options.noMcp);
+  }
+  if (hook.type === "config") {
+    return !options.agentsOnly && (!hook.requiresMcp || !options.noMcp);
+  }
+  return false;
+}) ?? false);
+const shouldRequirePackageManagerBinary = (selectedPackages, options) => !options.dryRun && (!options.noInstall || hasEnabledPackageHook(selectedPackages, options));
 const resolveInitCwd = (options) => {
   const cwd = path.resolve(options.cwd);
   if (!fs.existsSync(cwd)) {
@@ -4588,6 +4817,17 @@ const resolveInitSourceRoot = (cwd, options) => {
   }
   return path.join(cwd, "web");
 };
+const isGitWorkTree = (cwd) => {
+  try {
+    execFileSync("git", ["rev-parse", "--is-inside-work-tree"], {
+      cwd,
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    return true;
+  } catch {
+    return false;
+  }
+};
 const runUpdate = (options) => {
   const version = options.version ?? resolveLatestVersion();
   const packageJsonPaths = collectPackageJsonPaths(options.target);
@@ -4754,7 +4994,7 @@ const applyInitTemplate = (cwd, sourceRoot, packageManager, options, changes) =>
   writeFileIfAllowed(path.join(cwd, "scripts/publish-extension.mjs"), createPublishScript(), options, changes);
   writeFileIfAllowed(path.join(cwd, "README.md"), createReadme(cwd, sourceRoot, options, packageManager), options, changes);
 };
-const runInstall = (cwd, packageManager, options, changes, packageJsonChanged) => {
+const runInstall = async (cwd, packageManager, options, changes, packageJsonChanged) => {
   if (options.noInstall || options.agentsOnly) {
     return;
   }
@@ -4768,15 +5008,31 @@ const runInstall = (cwd, packageManager, options, changes, packageJsonChanged) =
     return;
   }
   try {
-    execFileSync(packageManager, args, {
-      cwd,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
+    await runCommandWithTerminalStatus(
+      packageManager,
+      args,
+      { cwd },
+      `Installing dependencies with ${packageManager}`
+    );
   } catch (error) {
     printExecErrorOutput(error);
     throw error;
   }
 };
+const applyInitGit = async (cwd, options, changes) => {
+  if (!options.initGit) {
+    return;
+  }
+  if (isGitWorkTree(cwd)) {
+    changes.skipped.push("git init skipped because cwd is already inside a Git work tree");
+    return;
+  }
+  changes.git.push("git init");
+  if (options.dryRun) {
+    return;
+  }
+  await runCommandWithTerminalStatus("git", ["init"], { cwd }, "Initializing Git repository");
+};
 const resolveInstallArgs = (packageManager) => {
   if (packageManager === "yarn" && resolvePackageManagerMajorVersion(packageManager) === 1) {
     return ["install", "--silent"];
@@ -4821,17 +5077,22 @@ const runInit = async (options) => {
   const resolvedOptions = version === "not used" ? interactiveOptions : { ...interactiveOptions, version };
   const packageManager = interactiveOptions.agentsOnly ? interactiveOptions.packageManager ?? detectPackageManagerByLockfile(cwd) ?? "npm" : await resolvePackageManager(cwd, interactiveOptions.packageManager);
   const changes = createInitChanges();
+  if (shouldRequirePackageManagerBinary(selectedPackages, resolvedOptions)) {
+    assertPackageManagerAvailable(packageManager);
+  }
   applyInitPreflight(cwd, sourceRoot, packageManager, selectedPackages, version, resolvedOptions, changes);
+  await applyInitGit(cwd, resolvedOptions, changes);
   let packageJsonPath = null;
   if (!resolvedOptions.agentsOnly) {
     packageJsonPath = applyInitPackageJson(cwd, selectedPackages, version, packageManager, resolvedOptions, changes);
+    updateGitignore(cwd, resolvedOptions, changes);
     applyInitDirectories(sourceRoot, resolvedOptions, changes);
     applyInitConfigs(cwd, sourceRoot, resolvedOptions, changes);
     applyInitTemplate(cwd, sourceRoot, packageManager, resolvedOptions, changes);
-    applyInitPackageConfigHooks(cwd, selectedPackages, packageManager, resolvedOptions, changes);
   }
-  applyInitAgents(cwd, selectedPackages, packageManager, resolvedOptions, changes);
-  runInstall(cwd, packageManager, resolvedOptions, changes, Boolean(packageJsonPath && changes.packageJson.length > 0));
+  await runInstall(cwd, packageManager, resolvedOptions, changes, Boolean(packageJsonPath && changes.packageJson.length > 0));
+  await applyInitPackageConfigHooks(cwd, selectedPackages, packageManager, resolvedOptions, changes);
+  await applyInitAgents(cwd, selectedPackages, packageManager, resolvedOptions, changes);
   printInitReport(cwd, sourceRoot, version, packageManager, changes, resolvedOptions);
 };
 const main = async (argv = process$2.argv.slice(2)) => {

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@retailcrm/embed-ui",
   "type": "module",
-  "version": "0.9.22-alpha.4",
+  "version": "0.9.22-alpha.7",
   "description": "API and components for creating RetailCRM UI extensions",
-  "repository": "git@github.com:retailcrm/embed-ui.git",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/retailcrm/embed-ui.git"
+  },
   "author": "RetailDriverLLC <integration@retailcrm.ru>",
   "license": "MIT",
   "contributors": [
@@ -19,7 +22,7 @@
     "./dist/*": "./dist/*",
     "./types/*": "./types/*"
   },
-  "bin": "./bin/embed-ui.mjs",
+  "bin": "bin/embed-ui.mjs",
   "files": [
     "bin",
     "dist",
@@ -54,10 +57,10 @@
     "@omnicajs/symfony-router": "^1.0.0",
     "@omnicajs/vue-remote": "^0.2.23",
     "@remote-ui/rpc": "^1.4.5",
-    "@retailcrm/embed-ui-v1-components": "^0.9.22-alpha.4",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.22-alpha.4",
-    "@retailcrm/embed-ui-v1-endpoint": "^0.9.22-alpha.4",
-    "@retailcrm/embed-ui-v1-types": "^0.9.22-alpha.4",
+    "@retailcrm/embed-ui-v1-components": "^0.9.22-alpha.7",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.22-alpha.7",
+    "@retailcrm/embed-ui-v1-endpoint": "^0.9.22-alpha.7",
+    "@retailcrm/embed-ui-v1-types": "^0.9.22-alpha.7",
     "yargs": "^17.7.2"
   },
   "devDependencies": {
@@ -66,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.22-alpha.4",
+    "@retailcrm/embed-ui-v1-testing": "^0.9.22-alpha.7",
     "@types/git-semver-tags": "^7.0.0",
     "@types/node": "^22.19.2",
     "@types/semver": "^7.7.1",