@retailcrm/embed-ui 0.9.22-alpha.3 → 0.9.22-alpha.5

package/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Changelog
 
 
+## [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
+
+* Deprecated deep equality dependency removed ([32abfbc](https://github.com/retailcrm/embed-ui/commit/32abfbc540609b4b3e611ca7dd5331d92be56d83))
+* Embed UI init output noise reduced ([d8d8c7b](https://github.com/retailcrm/embed-ui/commit/d8d8c7b99e1e0201fc4a4a8753931c799fdc005a))
+* Release job hang prevented ([17ca586](https://github.com/retailcrm/embed-ui/commit/17ca5861c2227936bf8ea2b24e2670a17a1e7295))
 ## [0.9.22-alpha.3](https://github.com/retailcrm/embed-ui/compare/v0.9.22-alpha.2...v0.9.22-alpha.3) (2026-05-18)
 
 ### Features

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`;
+- client configs для Codex CLI, Cursor, Junie и VS Code — не создаются без `--mcp-client-configs`;
+- Git — в неинтерактивном режиме не инициализируется без `--git`, а в интерактивном режиме предлагается, если корень проекта не является Git-репозиторием;
 - существующие файлы не перезаписываются, а зависимости с потенциальным конфликтом не заменяются без явных force-флагов.
 
 По умолчанию команда использует текущий рабочий каталог как корень проекта. Его можно задать явно:
@@ -74,6 +78,7 @@ npx @retailcrm/embed-ui init ./web --cwd ./my-project --package-manager npm
 
 - `--no-install` — не запускать установку зависимостей после изменения `package.json`.
 - `--interactive` — задать основные параметры через TTY-интерфейс со списками выбора, сохранив флаги как явные ограничения.
+- `--verbose` — вывести подробный список изменений после `init`; без него CLI печатает краткую сводку.
 - `--version 0.9.21` — использовать указанную версию пакетов вместо версии запущенного CLI.
 - `--exact` — записывать точные версии вместо диапазонов.
 - `--packages embed-ui,components,contexts,types,endpoint` — явно выбрать пакеты для установки и настройки.
@@ -84,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` — дополнительно подключить или создать конфиги поддерживаемых AI-клиентов.
+- `--git` — выполнить `git init` в корне проекта, если каталог еще не является Git-репозиторием.
 
 `--force` включает силовой режим для управляемых частей, но учитывает флаги `--no-*`. Например, можно обновить только
 агентские инструкции и MCP-настройки без перегенерации стартовых файлов:
@@ -110,7 +116,7 @@ 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
 ```
 
 Повторный запуск без `--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";
@@ -27,13 +27,15 @@ Options:
       --cwd <path>        Project working directory for init
       --package-manager   Package manager for init installs
       --interactive       Ask init questions with TTY selection prompts
+      --verbose           Print detailed init change lists
       --no-install        Do not run package manager install in init mode
       --no-configs        Do not create root TypeScript, Vite, ESLint and env config files
       --force-deps        Replace incompatible existing init dependencies
       --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 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:
@@ -109,10 +111,14 @@ const parseInitArgs = (argv) => {
     type: "string",
     default: "order/card:common.after",
     describe: "Starter widget target"
-  }).option("dry-run", { type: "boolean", default: false }).option("exact", { type: "boolean", default: false }).option("interactive", { type: "boolean", default: false }).option("install", { type: "boolean", default: true }).option("force", { type: "boolean", default: false }).option("force-deps", { type: "boolean", default: false }).option("fix-sections", { type: "boolean", default: false }).option("force-files", { type: "boolean", default: false }).option("configs", { type: "boolean", default: true }).option("dirs-enabled", { type: "boolean", default: true }).option("template-enabled", { type: "boolean", default: true }).option("agents", { type: "boolean", default: true }).option("force-agents", { type: "boolean", default: false }).option("agents-only", { type: "boolean", default: false }).option("mcp", { type: "boolean", default: true }).option("force-mcp", { type: "boolean", default: false }).option("mcp-client-configs", {
+  }).option("dry-run", { type: "boolean", default: false }).option("exact", { type: "boolean", default: false }).option("interactive", { type: "boolean", default: false }).option("verbose", { type: "boolean", default: false }).option("install", { type: "boolean", default: true }).option("force", { type: "boolean", default: false }).option("force-deps", { type: "boolean", default: false }).option("fix-sections", { type: "boolean", default: false }).option("force-files", { type: "boolean", default: false }).option("configs", { type: "boolean", default: true }).option("dirs-enabled", { type: "boolean", default: true }).option("template-enabled", { type: "boolean", default: true }).option("agents", { type: "boolean", default: true }).option("force-agents", { type: "boolean", default: false }).option("agents-only", { type: "boolean", default: false }).option("mcp", { type: "boolean", default: true }).option("force-mcp", { type: "boolean", default: false }).option("mcp-client-configs", {
     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);
@@ -136,6 +142,7 @@ const parseInitArgs = (argv) => {
     with: parsed.with ?? null,
     packageManager: parsed.packageManager ?? null,
     interactive: parsed.interactive,
+    verbose: parsed.verbose,
     noInstall: !parsed.install,
     force: parsed.force,
     forceDeps: parsed.forceDeps,
@@ -154,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) => {
@@ -455,12 +463,13 @@ const INIT_RUNTIME_DEPENDENCIES = [
   { name: "@remote-ui/rpc", range: "^1.4.7" },
   { name: "pinia", range: "^2.2" },
   { name: "vue", range: "^3.5" },
-  { name: "vue-i18n", range: "^11" }
+  { name: "vue-i18n", range: "^11" },
+  { name: "zod", range: "^4.4" }
 ];
 const INIT_DEV_DEPENDENCIES = [
   { name: "@eslint/js", range: "^9.39" },
-  { name: "@intlify/eslint-plugin-vue-i18n", range: "~4.3.0" },
-  { name: "@intlify/unplugin-vue-i18n", range: "^11.1" },
+  { name: "@intlify/eslint-plugin-vue-i18n", range: "^4.4" },
+  { name: "@intlify/unplugin-vue-i18n", range: "^11.2" },
   { name: "@omnicajs/eslint-plugin-dependencies", range: "^0.0.2" },
   { name: "@types/node", range: "^22.19" },
   { name: "@vitejs/plugin-vue", range: "^6.0" },
@@ -607,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",
@@ -623,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;
@@ -640,7 +727,7 @@ const resolveDownloadCommand = (packageName, binName, packageManager, args, pack
         source: "transient"
       };
     }
-    const commandArgs2 = ["-y", "-p", packageSpec, binName, ...args];
+    const commandArgs2 = ["-y", "--loglevel=error", "-p", packageSpec, binName, ...args];
     return {
       command: "npx",
       args: commandArgs2,
@@ -666,7 +753,7 @@ const resolveDownloadCommand = (packageName, binName, packageManager, args, pack
       source: "transient"
     };
   }
-  const commandArgs = ["exec", "--yes", "--package", packageSpec, "--", binName, ...args];
+  const commandArgs = ["exec", "--yes", "--loglevel=error", "--package", packageSpec, "--", binName, ...args];
   return {
     command: "npm",
     args: commandArgs,
@@ -674,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 {
@@ -692,12 +779,29 @@ const resolvePackageHookCommand = (cwd, packageName, binName, packageManager, ar
   return resolveDownloadCommand(packageName, binName, packageManager, args, packageVersion, versionResolver);
 };
 const getExecErrorMessage = (error) => {
+  if (error && typeof error === "object") {
+    const output = [
+      "stderr" in error ? error.stderr : null,
+      "stdout" in error ? error.stdout : null
+    ].map((value) => value instanceof Buffer ? value.toString("utf8") : value).filter((value) => typeof value === "string" && value.trim().length > 0).map((value) => value.trim()).join("\n");
+    if (output) {
+      return output;
+    }
+  }
   if (error instanceof Error && error.message) {
     return error.message;
   }
   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,
@@ -711,10 +815,13 @@ const runPackageHookCommand = (cwd, packageName, binName, packageManager, args,
     return;
   }
   try {
-    execFileSync(command.command, command.args, {
-      cwd,
-      stdio: "inherit"
-    });
+    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)}`);
@@ -759,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,
@@ -775,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;
   }
@@ -789,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,
@@ -801,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") {
@@ -817,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,
@@ -900,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");
@@ -1070,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) {
@@ -2190,6 +2327,7 @@ const createInitChanges = () => ({
   files: [],
   agents: [],
   mcp: [],
+  git: [],
   hooks: [],
   install: null,
   skipped: [],
@@ -2209,6 +2347,10 @@ const printChanges = (changes) => {
   }
 };
 const printInitReport = (cwd, sourceRoot, version, packageManager, changes, options) => {
+  if (!options.verbose && !options.dryRun) {
+    printInitSummary(cwd, sourceRoot, version, packageManager, changes);
+    return;
+  }
   console.log(`CWD: ${cwd}`);
   console.log(`Target: ${sourceRoot}`);
   console.log(`Resolved version: ${version}`);
@@ -2236,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) {
@@ -2260,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");
@@ -2284,6 +2434,43 @@ const printInitReport = (cwd, sourceRoot, version, packageManager, changes, opti
     console.log("Dry run enabled, no files were modified.");
   }
 };
+const printInitSummary = (cwd, sourceRoot, version, packageManager, changes) => {
+  console.log(`Initialized ${cwd}`);
+  console.log(`  source root: ${sourceRoot}`);
+  console.log(`  version: ${version}`);
+  console.log(`  package manager: ${packageManager}`);
+  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 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");
+  if (summary.length > 0) {
+    console.log("");
+    console.log("changes");
+    for (const item of summary) {
+      console.log(`  ${item}`);
+    }
+  }
+  if (changes.skipped.length > 0) {
+    console.log("");
+    console.log("skipped");
+    for (const skipped of changes.skipped) {
+      console.log(`  ${skipped}`);
+    }
+  }
+  if (changes.warnings.length > 0) {
+    console.log("");
+    console.log("warnings");
+    for (const warning of new Set(changes.warnings)) {
+      console.log(`  ${warning}`);
+    }
+  }
+};
 const isUpKey = (key, keybindings = []) => (
   // The up key
   key.name === "up" || // Vim keybinding: hjkl keys map to left/down/up/right
@@ -4320,6 +4507,7 @@ const INIT_ACTION_LABELS = {
   template: "Создать стартовый шаблон",
   agents: "Обновить AGENTS.md",
   mcp: "Добавить MCP-настройки",
+  git: "Инициализировать Git",
   install: "Запустить установку зависимостей"
 };
 const INIT_ACTION_DESCRIPTIONS = {
@@ -4327,8 +4515,20 @@ 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 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;
@@ -4373,6 +4573,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");
   }
@@ -4384,6 +4587,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) => {
@@ -4406,12 +4610,18 @@ 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"
     }))
   });
 };
@@ -4445,6 +4655,49 @@ const resolveInteractiveInitOptions = async (cwd, options, detectedPackageManage
   );
   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 = [
@@ -4456,15 +4709,9 @@ 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;
 };
 const promptForPackageManager = async () => {
   const readline2 = createInterface({
@@ -4509,6 +4756,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)) {
@@ -4532,6 +4789,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);
@@ -4698,7 +4966,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;
   }
@@ -4706,15 +4974,64 @@ const runInstall = (cwd, packageManager, options, changes, packageJsonChanged) =
     changes.skipped.push("install skipped because package.json was not changed");
     return;
   }
-  const args = ["install"];
+  const args = resolveInstallArgs(packageManager);
   changes.install = `${packageManager} ${args.join(" ")}`;
   if (options.dryRun) {
     return;
   }
-  execFileSync(packageManager, args, {
-    cwd,
-    stdio: "inherit"
-  });
+  try {
+    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"];
+  }
+  if (packageManager === "npm") {
+    return ["install", "--loglevel=error"];
+  }
+  if (packageManager === "pnpm") {
+    return ["install", "--loglevel=error"];
+  }
+  if (packageManager === "bun") {
+    return ["install", "--silent"];
+  }
+  return ["install"];
+};
+const printExecErrorOutput = (error) => {
+  if (!error || typeof error !== "object") {
+    return;
+  }
+  const execError = error;
+  for (const field of ["stdout", "stderr"]) {
+    const value = execError[field];
+    const output = value instanceof Buffer ? value.toString("utf8") : value;
+    if (typeof output === "string" && output.trim().length > 0) {
+      console.error(output.trim());
+    }
+  }
 };
 const runInit = async (options) => {
   const cwd = resolveInitCwd(options);
@@ -4732,17 +5049,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,7 +1,7 @@
 {
   "name": "@retailcrm/embed-ui",
   "type": "module",
-  "version": "0.9.22-alpha.3",
+  "version": "0.9.22-alpha.5",
   "description": "API and components for creating RetailCRM UI extensions",
   "repository": "git@github.com:retailcrm/embed-ui.git",
   "author": "RetailDriverLLC <integration@retailcrm.ru>",
@@ -54,10 +54,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.3",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.22-alpha.3",
-    "@retailcrm/embed-ui-v1-endpoint": "^0.9.22-alpha.3",
-    "@retailcrm/embed-ui-v1-types": "^0.9.22-alpha.3",
+    "@retailcrm/embed-ui-v1-components": "^0.9.22-alpha.5",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.22-alpha.5",
+    "@retailcrm/embed-ui-v1-endpoint": "^0.9.22-alpha.5",
+    "@retailcrm/embed-ui-v1-types": "^0.9.22-alpha.5",
     "yargs": "^17.7.2"
   },
   "devDependencies": {
@@ -66,7 +66,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.3",
+    "@retailcrm/embed-ui-v1-testing": "^0.9.22-alpha.5",
     "@types/git-semver-tags": "^7.0.0",
     "@types/node": "^22.19.2",
     "@types/semver": "^7.7.1",