@mirta/cli 0.4.7 → 0.4.9

package/README.md

@@ -51,6 +51,7 @@ These global options are available for all commands:
 - `--help` (`-h`) — displays help on available commands and options.
 - `--version` (`-v`) — prints `@mirta/cli` version.
 - `--locale <loc>` — sets the interface language (`en`, `ru`).
+- `--debug` — enables debug mode with detailed logging output.
 
 ### `pnpm mirta release`
 
@@ -84,7 +85,7 @@ The process is divided into stages:
 
 #### Supported Options
 
-- `--dry-run` (`--dry`) — simulation mode, shows changes without applying them.
+- `--dry-run` — simulation mode, shows changes without applying them.
 - `--preid` `<id>` — custom prerelease identifier (`alpha.0`, `beta.1`).
 - `--skip-prompts` — skips interactive prompts, uses defaults.
 - `--skip-git` — skips commit and tag creation.
@@ -219,7 +220,7 @@ In CI, `--provenance` is added to attest package origin.
 
 #### Supported Options
 
-- `--dry-run` (`--dry`) — simulation mode.
+- `--dry-run` — simulation mode.
 - `--skip-build` — skips running `pnpm run build`.
 - `--skip-git` — disables git checks (equivalent to `--no-git-checks` in `pnpm publish`).
 
@@ -237,9 +238,10 @@ Synchronizes files with Wiren Board controllers via `rsync` over SSH.
 - Authentication:
   - Uses an isolated `ssh-agent`.
   - Supports PKCS#11 (Rutoken) and SSH keys.
-  - `ttl` — key lifetime (e.g., `1h`).
-- `--dry-run` mode: shows changes without applying.
+  - `ttl` — passphrase/PIN lifetime in ssh-agent (e.g., `1h`).
+  - Password authentication is supported but does not use ssh-agent and has no TTL support.
 - Symbolic links are not transferred — should be created on the controller manually.
+- `--dry-run` mode: shows changes without applying.
 
 </details>
 
@@ -249,6 +251,8 @@ Synchronizes files with Wiren Board controllers via `rsync` over SSH.
 - `--profile`, `-p <name>` — deployment profile (default: `default`).
 - `--to <conn>` — override connection string.
 - `--dry-run` — simulate synchronization.
+- `--insecure` — disables security warnings.
+
 Parameter `--to` accepts:
 - Connection name from `mirta.config.json`,
 - Connection string starting with `ssh://`.

package/README.ru.md

@@ -57,6 +57,7 @@ pnpm mirta deploy
 - `--help` (`-h`) — отображает справку по доступным командам и параметрам.
 - `--version` (`-v`) — выводит версию `@mirta/cli`.
 - `--locale <loc>` — задаёт язык интерфейса (`en`, `ru`).
+- `--debug` — включает режим отладки с подробным выводом логов.
 
 ### `pnpm mirta release`
 
@@ -90,7 +91,7 @@ pnpm mirta deploy
 
 #### Поддерживаемые опции
 
-`--dry-run` (`--dry`) — симуляция без применения изменений.
+`--dry-run` — симуляция без применения изменений.
 
 `--preid` `<id>` — кастомный префикс преверсии (`alpha.0`, `beta.1`).
 
@@ -230,7 +231,7 @@ pnpm mirta release prerelease --preid alpha
 
 #### Поддерживаемые опции
 
-- `--dry-run` (`--dry`) — симуляция.
+- `--dry-run` — симуляция.
 - `--skip-build` — пропускает `pnpm run build`.
 - `--skip-git` — отключает git-проверки (аналог `--no-git-checks` в `pnpm publish`).
 
@@ -247,8 +248,9 @@ pnpm mirta release prerelease --preid alpha
 - Поддержка WSL2: на Windows команды выполняются внутри WSL.
 - Аутентификация:
   - Через изолированный `ssh-agent`.
-  - Поддержка PKCS#11 (Rutoken) и SSH-ключей.
-  - `ttl` — время жизни ключа.
+  - Поддержка PKCS#11 (Rutoken) и SSH-ключей (с парольной фразой или без неё).
+  - `ttl` — время жизни парольной фразы/PIN в ssh-agent (например, `1h`).
+  - Парольная аутентификация поддерживается, но не использует ssh-agent и не поддерживает TTL.
 - Режим `--dry-run`: показывает изменения без применения.
 - Симлинки не передаются.
 
@@ -260,6 +262,7 @@ pnpm mirta release prerelease --preid alpha
 - `--profile`, `-p <name>` — профиль деплоя (по умолчанию: `default`).
 - `--to <conn>` — переопределение подключения.
 - `--dry-run` — симуляция синхронизации.
+- `--insecure` — отключает предупреждения безопасности.
 
 Параметр `--to` принимает:
 - Название подключения из файла конфигурации `mirta.config.json`, 

package/dist/deploy.mjs

@@ -368,6 +368,9 @@ const options = ({
     'to': {
         type: 'string',
     },
+    'insecure': {
+        type: 'boolean',
+    },
     // Deprecated. Use 'dry-run' instead
     'dry': {
         type: 'boolean',
@@ -849,27 +852,23 @@ async function authenticateAsync(connection) {
  * @since 0.4.0
  *
  **/
-async function hasRemoteGroupAsync(group, connection) {
+async function hasRemoteGroupAsync(group, connection, isPasswordAuth) {
     const { hostname, username, port } = connection;
     const args = [];
     if (port)
         args.push('-p', String(port));
     args.push(`${username}@${hostname}`, `getent group ${group} > /dev/null 2>&1`);
-    try {
-        const result = await runCommandAsync.inUnixShell(connection.wsl)('ssh', args, {
-            env: {
-                SSH_AUTH_SOCK,
-            },
-            stdio: STDIO_CAPTURE_ERRORS,
-            doneCodes: [0, 2],
-            cancelCodes: [130],
-        });
-        return result.code === 0;
-    }
-    catch (e) {
-        logger.warn(e instanceof Error ? e.message : String(e));
-        return false;
-    }
+    const result = await runCommandAsync.inUnixShell(connection.wsl)('ssh', args, {
+        env: {
+            SSH_AUTH_SOCK,
+        },
+        stdio: isPasswordAuth
+            ? STDIO_INTERACTIVE
+            : STDIO_CAPTURE_ERRORS,
+        doneCodes: [0, 2],
+        cancelCodes: [130],
+    });
+    return result.code === 0;
 }
 
 /**
@@ -1011,14 +1010,21 @@ async function runAsync(args) {
     }));
     // Аутентификация через ssh-agent (PKCS#11 или ключ).
     await authenticateAsync(connection);
+    const isPasswordAuth = !connection.key && !connection.pkcs11;
+    const allowInsecure = argv.insecure;
+    if (isPasswordAuth && !allowInsecure)
+        logger.warn([
+            t('connection.useKeyAuth') + '\n',
+            'https://wiki.wirenboard.com/wiki/SSH\n',
+        ]);
     if (!profile.toGroup) {
         // Если группа не указана явно,
         // то проверяем наличие рекомендуемой группы.
-        const isGroupExists = await hasRemoteGroupAsync(RECOMMENDED_GROUP, connection);
+        const isGroupExists = await hasRemoteGroupAsync(RECOMMENDED_GROUP, connection, isPasswordAuth);
         if (isGroupExists) {
             profile.toGroup = RECOMMENDED_GROUP;
         }
-        else {
+        else if (!allowInsecure) {
             // Если группы на контроллере нет,
             // то выводим рекомендацию использовать отдельную группу.
             logger.warn(t('deploy.useDedicatedGroup', { group: RECOMMENDED_GROUP }));

package/dist/index.mjs

@@ -616,7 +616,7 @@ async function assertWorkflowResultAsync(repository, name) {
 
 const { dim, yellow } = chalk;
 const helpMessageEn = `\
-Performs operations over monorepo projects powered by the Mirta Framework.
+Performs operations over projects powered by the Mirta Framework.
 
 ${yellow('Usage:')}
   mirta [command] [options...]
@@ -626,16 +626,20 @@ ${yellow('Global flags:')}
     ${dim('Displays help information about available commands and options.')}
   --version, -v
     ${dim('Prints the version of this CLI utility.')}
+  --dry-run
+    ${dim('Runs the command in simulation mode. Does not apply changes.')}
+  --debug
+    ${dim('Enables debug mode with detailed logging output.')}
 
 ${yellow('Commands:')}
   release
   ${dim('Increase package versions following semantic versioning rules.')}
   publish
   ${dim('Builds and publishes packages to npm registry.')}
+  deploy
+  ${dim('Deploy project files to Wiren Board controller.')}
 
 ${yellow(`Options for 'release':`)}
-  --dry-run, --dry
-    ${dim('Runs the command in simulation mode. Shows what would change but does not apply modifications.')}
   --preid <id>
     ${dim('Sets a custom pre-release identifier (e.g., `alpha`, `beta.1`, `rc`).')}
   --skip-prompts
@@ -644,15 +648,23 @@ ${yellow(`Options for 'release':`)}
     ${dim('Disables creating a commit and tag. Git changes remain uncommitted.')}
 
 ${yellow(`Options for 'publish':`)}
-  --dry-run, --dry
-    ${dim('Runs in simulation mode. Shows what would happen, but does not publish')}
   --skip-build
   ${dim('Skips running `pnpm run build` before publishing.')}
   --skip-git
     ${dim('Disables git state checks (equivalent to `--no-git-checks` in `pnpm publish`).')}
+
+${yellow(`Options for 'deploy':`)}
+  --profile <name>, -p
+    ${dim('Use specified deploy profile.')}
+  --to <connection>
+    ${dim('Override connection string from profile.')}
+  --config <path>, -c
+    ${dim('Use custom configuration file.')}
+  --insecure
+    ${dim('Disable security warnings.')}
 `;
 const helpMessageRu = `\
-Выполняет операции над проектами монорепозитория, работающими на базе фреймворка Mirta.
+Выполняет операции над проектами, работающими на базе фреймворка Mirta.
 
 ${yellow('Использование:')}
   mirta [command] [options...]
@@ -668,24 +680,34 @@ ${yellow('Общие флаги:')}
     ${dim('Отображает справку по доступным командам и параметрам.')}
   --version, -v
     ${dim('Выводит версию данной утилиты.')}
+  --dry-run
+    ${dim('Режим симуляции. Показывает изменения, но не применяет их.')}
+  --debug
+    ${dim('Включает режим отладки с подробным выводом логов.')}
 
 ${yellow(`Опции для 'release':`)}
-  --dry-run, --dry
-    ${dim('Запускает команду в режиме симуляции. Показывает изменения, но не применяет их.')}
   --preid <id>
-    ${dim('Задаёт кастомный префикс для преверсии (например, `alpha`, `beta.1`, `rc`).')}
+    ${dim('Задаёт кастомный префикс преверсии (например, `alpha`, `beta.1`, `rc`).')}
   --skip-prompts
     ${dim('Пропускает интерактивные запросы. Используются значения по умолчанию.')}
   --skip-git
     ${dim('Не создаёт коммит и тег. Git-изменения остаются в рабочей директории.')}
 
 ${yellow(`Опции для 'publish':`)}
-  --dry-run, --dry
-    ${dim('Запускает команду в режиме симуляции. Показывает изменения, но не применяет их.')}
   --skip-build
     ${dim('Пропускает выполнение `pnpm run build` перед публикацией')}
   --skip-git
     ${dim('Отключает проверки git-состояния (аналог `--no-git-checks` в `pnpm publish`)')}
+
+${yellow(`Опции для 'deploy':`)}
+  --profile <name>, -p
+    ${dim('Использовать указанный профиль деплоя.')}
+  --to <connection>
+    ${dim('Переопределить строку подключения из профиля.')}
+  --config <path>, -c
+    ${dim('Использовать кастомный файл конфигурации.')}
+  --insecure
+    ${dim('Отключить предупреждения безопасности.')}
 `;
 const getHelpMessage = () => getLocale() === 'ru-RU'
     ? helpMessageRu

package/locales/en-US.json

@@ -16,6 +16,7 @@
   "step.canceled": "Operation canceled",
   "connection.emptyParameterSkipped": "Empty connection parameter '{key}' skipped",
   "connection.ttlSkipped": "TTL parameter skipped — no pkcs11 or key specified",
+  "connection.useKeyAuth": "Use key-based authentication for better security",
   "package.templateOutsideRoot": "Template '{template}' is outside the root directory",
   "release.versionUpdated": "Version updated to {newVersion}",
   "release.versionReverting": "Release canceled. Reverting version...",

package/locales/ru-RU.json

@@ -16,6 +16,7 @@
   "step.canceled": "Операция отменена",
   "connection.emptyParameterSkipped": "Пустой параметр подключения '{key}' пропущен",
   "connection.ttlSkipped": "Параметр TTL пропущен — не указаны PKCS#11 или ключ",
+  "connection.useKeyAuth": "Используйте подключение к SSH по ключу для повышения безопасности",
   "package.templateOutsideRoot": "Пропуск шаблона {template} — вне корневой директории",
   "release.versionUpdated": "Версия обновлена до {newVersion}",
   "release.versionReverting": "Релиз отменён. Откат версии...",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mirta/cli",
   "description": "🛠️ Mirta Framework - the CLI",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "license": "Unlicense",
   "keywords": [
     "cli",
@@ -51,12 +51,12 @@
     "prompts": "^2.4.2",
     "semver": "^7.7.3",
     "jsonc-parser": "^3.3.1",
-    "@mirta/basics": "0.4.7",
-    "@mirta/i18n": "0.4.7",
-    "@mirta/env-loader": "0.4.7",
-    "@mirta/package": "0.4.7",
-    "@mirta/staged-args": "0.4.7",
-    "@mirta/workspace": "0.4.7"
+    "@mirta/basics": "0.4.9",
+    "@mirta/package": "0.4.9",
+    "@mirta/i18n": "0.4.9",
+    "@mirta/staged-args": "0.4.9",
+    "@mirta/env-loader": "0.4.9",
+    "@mirta/workspace": "0.4.9"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1"