@dr-co/dsh-node-client 0.0.0-stage → 0.0.59

package/lib/api.mjs

@@ -0,0 +1,177 @@
+/**
+ * Клиентская часть протокола: заявка, объявление, опрос команд, результат.
+ *
+ * Ничего не знает про CLI — всё принимает явными параметрами, чтобы это можно
+ * было тестировать без процессов и терминала.
+ *
+ * @module dsh-node-client/api
+ */
+import { randomUUID } from 'node:crypto'
+import { readFileSync } from 'node:fs'
+
+import { t } from './i18n.mjs'
+
+/** Версия протокола, которую объявляем серверу (`proto`). */
+export const PROTO = 1
+// Версия берётся из package.json: зашитая строка врала в админке (все узлы
+// показывались как 0.0.1, сколько бы клиент ни обновляли).
+const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
+export const CLIENT_VERSION = `dshnc/${pkg.version}`
+/** Голая версия клиента: `dshnc version` и строка в логе при старте демона. */
+export const VERSION = pkg.version
+
+/** Ошибка протокола: HTTP-код + код из закрытого словаря. */
+export class NodeError extends Error {
+  constructor (status, code, message) {
+    super(message)
+    this.status = status
+    this.code = code
+  }
+}
+
+async function request (base, path, { method = 'GET', token, body, timeoutMs = 30000 } = {}) {
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), timeoutMs)
+  try {
+    const response = await fetch(base + path, {
+      method,
+      headers: {
+        ...(token ? { authorization: `Bearer ${token}` } : {}),
+        ...(body ? { 'content-type': 'application/json' } : {}),
+      },
+      body: body ? JSON.stringify(body) : undefined,
+      signal: controller.signal,
+    })
+    const text = await response.text()
+    const payload = text ? JSON.parse(text) : {}
+    if (!response.ok) {
+      if (response.status === 401) {
+        if (process.env.DSHNC_DEBUG) {
+          // eslint-disable-next-line no-console
+          console.error(`[debug] 401 ${path} token=${String(token ?? '').slice(0, 8)}…`)
+        }
+        throw new NodeError(401, 'unauthorized', t('api.unauthorized'))
+      }
+      throw new NodeError(response.status, payload.code ?? 'bad_request', payload.message ?? t('api.http', { status: response.status }))
+    }
+    return { status: response.status, body: payload }
+  } catch (error) {
+    if (error instanceof NodeError) throw error
+    if (error.name === 'AbortError') throw new NodeError(0, 'timeout', t('api.timeout'))
+    throw new NodeError(0, 'network', error.message)
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+/** Заявка на регистрацию (план §9.1). */
+export async function enroll (base, { uuid, name, aliases, nonce }) {
+  return request(base, '/v1/enroll', {
+    method: 'POST',
+    body: { uuid, name, aliases, nonce: nonce ?? null, proto: PROTO, clientVersion: CLIENT_VERSION },
+  })
+}
+
+/** Опрос заявки: 202 пока ждёт, 200 с токеном после одобрения. */
+export async function enrollStatus (base, uuid, nonce = null) {
+  try {
+    const query = nonce ? `?nonce=${encodeURIComponent(nonce)}` : ''
+    return await request(base, `/v1/enroll/${encodeURIComponent(uuid)}${query}`)
+  } catch (error) {
+    if (error.status === 202) return { status: 202, body: { status: 'pending' } }
+    throw error
+  }
+}
+
+/**
+ * Разобрать ссылку подключения: `.../dsh-nodes/pair?v=<код>`.
+ * @param {string} input
+ * @returns {{base: string, code: string|null}}
+ */
+export function parseConnectUrl (input) {
+  const url = new URL(input)
+  const code = url.searchParams.get('v') ?? url.searchParams.get('code') ?? null
+  const path = url.pathname.replace(/\/+$/, '').replace(/\/(pair||enroll)$/, '')
+  url.search = ''
+  url.hash = ''
+  url.pathname = path || '/dsh-nodes'
+  return { base: `${url.origin}${url.pathname}`, code }
+}
+
+/** Обменять код подключения на токен: подтверждать в админке нечего. */
+export async function pair (base, { code, uuid, name, aliases }) {
+  return request(base, '/v1/pair', {
+    method: 'POST',
+    body: { code, uuid, name, aliases, proto: PROTO, clientVersion: CLIENT_VERSION },
+  })
+}
+
+/** Объявить, что умеем. */
+export async function announce (base, token, apis, { workdir = null, access = null, allowEscalation = true, uptimeSeconds = null, approver = null, startMode = null } = {}) {
+  return request(base, '/v1/announce', {
+    method: 'PUT',
+    token,
+    // потолок прав и «можно ли спрашивать» нужны серверу, чтобы решать,
+    // задавать ли вопрос человеку при отказе песочницы
+    body: { apis, proto: PROTO, clientVersion: CLIENT_VERSION, workdir, access, allowEscalation, uptimeSeconds, approver, base: startMode },
+  })
+}
+
+/**
+ * Забрать пачку команд на исполнение.
+ *
+ * Курсора больше нет: сервер отдаёт с головы очереди и сразу помечает взятое
+ * как `processing`, повторно не выдаёт. `limit` — сколько взять за раз.
+ */
+export async function commands (base, token, { limit = 5 } = {}) {
+  return request(base, `/v1/commands?limit=${limit}`, { token })
+}
+
+/** Вернуть результат команды. «Уже закрыта» — только 409. */
+export async function result (base, token, seq, payload) {
+  try {
+    return await request(base, `/v1/commands/${seq}/result`, { method: 'POST', token, body: payload })
+  } catch (error) {
+    // 404 — это не «уже закрыта», а «такого маршрута нет»: проглотить его значит
+    // молча потерять результат и всё равно сдвинуть курсор
+    if (error.status === 409) return { status: 409, body: { ok: false, late: true } }
+    throw error
+  }
+}
+
+/** Счётчики узла: нужны для сверки поколения и наличия работы. */
+export async function state (base, token) {
+  return request(base, '/v1/state', { token })
+}
+
+/** API, которое умеет клиент из коробки: одна команда bash. */
+export function bashApi ({ shell = '/bin/sh', defaultTimeout = 60 } = {}) {
+  return {
+    name: 'bash',
+    version: '2',
+    description: t('bash.api.description'),
+    methods: [
+      {
+        method: 'exec',
+        description: t('bash.exec.description'),
+        args: {
+          type: 'object',
+          properties: {
+            command: { type: 'string', description: t('bash.arg.command') },
+            cwd: { type: 'string', description: t('bash.arg.cwd') },
+            timeout: { type: 'number', description: t('bash.arg.timeout') },
+            stdin: { type: 'string', description: t('bash.arg.stdin') },
+          },
+          required: ['command'],
+          additionalProperties: false,
+        },
+        meta: { shell, defaultTimeout },
+      },
+    ],
+  }
+}
+
+/** Свежий uuid на случай, если в конфиге его нет. */
+export function newUuid () {
+  return randomUUID()
+}

package/lib/approver.mjs

@@ -0,0 +1,138 @@
+/**
+ * Локальный апрув: спросить человека за этой машиной.
+ *
+ * Работает через внешнюю команду из настроек узла — `zenity`, `notify-send`,
+ * `powershell`, что угодно. Отдельный модуль, потому что тут легко ошибиться:
+ * текст вопроса приходит извне (его собрал сервер из команды модели), и
+ * подставлять его прямо в командную строку нельзя — это была бы инъекция.
+ *
+ * Поэтому: `%s` в шаблоне заменяется на экранированный текст, а полный JSON
+ * уходит на stdin. Команда запускается без оболочки, списком аргументов.
+ *
+ * @module dsh-node-client/approver
+ */
+import { spawn } from 'node:child_process'
+
+/**
+ * Аргументы команды апрува.
+ *
+ * Два способа передать текст:
+ *  - в шаблоне есть `%s` → подставляем в аргумент (для `zenity --question --text=%s`);
+ *  - нет `%s` → текст уходит на stdin (для `zenity --text-info`), и тогда длина
+ *    вопроса ничем не ограничена командной строкой.
+ *
+ * Разбиение делается до подстановки: иначе пробелы из вопроса разорвали бы
+ * аргумент на части. Оболочки здесь нет, поэтому экранировать нечего.
+ */
+export function buildArgs (template, prompt) {
+  const args = splitArgs(template)
+  if (!template.includes('%s')) return args
+  return args.map((arg) => arg.replaceAll('%s', String(prompt)))
+}
+
+/** Пойдёт ли текст в аргументы или на stdin. */
+export function usesStdin (template) {
+  return !String(template).includes('%s')
+}
+
+/** Разбить строку на аргументы, уважая кавычки. */
+export function splitArgs (template) {
+  const args = []
+  let current = ''
+  let quote = null
+  for (const char of template) {
+    if (quote) {
+      if (char === quote) quote = null
+      else current += char
+      continue
+    }
+    if (char === '"' || char === "'") {
+      quote = char
+      continue
+    }
+    if (/\s/.test(char)) {
+      if (current) args.push(current)
+      current = ''
+      continue
+    }
+    current += char
+  }
+  if (current) args.push(current)
+  return args
+}
+
+/**
+ * Спросить человека.
+ *
+ * `ok` команды = «разрешаю»: инструмент задаёт вопрос так, что код 0 означает
+ * согласие (`zenity --question` возвращает 0 на «Yes»), ненулевой — отказ или
+ * закрытое окно. Это же поведение у `notify-send` с действиями не получится,
+ * поэтому для таких случаев нужен свой скрипт — конфиг это позволяет.
+ *
+ * @param {object} options
+ * @param {string} options.tool команда из настроек
+ * @param {string} options.prompt текст вопроса
+ * @param {string} options.payload JSON для stdin
+ * @param {AbortSignal} [options.signal]
+ * @param {number} [options.timeout] секунды
+ * @returns {Promise<boolean>} true — разрешено
+ */
+export function askLocally ({ tool, prompt, payload, signal, timeout = 86400 }) {
+  return new Promise((resolve, reject) => {
+    const argv = buildArgs(tool, prompt)
+    if (!argv.length) {
+      reject(Object.assign(new Error('пустая команда апрува'), { code: 'no_local_approver' }))
+      return
+    }
+    // структурированные данные — в окружение, человеку — текст на stdin
+    const env = {
+      ...process.env,
+      DSHNC_APPROVAL_ID: String(payload?.id ?? ''),
+      DSHNC_APPROVAL_MODE: String(payload?.mode ?? ''),
+      // в рамках чего спрашиваем: сессия и вопрос (корневой вызов хода)
+      DSHNC_SESSION: String(payload?.session ?? ''),
+      DSHNC_QUESTION: String(payload?.question?.rootCallId ?? ''),
+      DSHNC_CALL: String(payload?.question?.callId ?? ''),
+    }
+    const child = spawn(argv[0], argv.slice(1), { stdio: ['pipe', 'ignore', 'pipe'], env })
+    let stderr = ''
+    let settled = false
+    const finish = (fn, value) => {
+      if (settled) return
+      settled = true
+      clearTimeout(timer)
+      signal?.removeEventListener?.('abort', onAbort)
+      fn(value)
+    }
+    const onAbort = () => {
+      try {
+        child.kill('SIGTERM')
+      } catch {}
+      finish(reject, Object.assign(new Error('апрув отменён'), { code: 'cancelled' }))
+    }
+    const timer = setTimeout(() => {
+      try {
+        child.kill('SIGTERM')
+      } catch {}
+      finish(reject, Object.assign(new Error('апрув истёк'), { code: 'approve_timeout' }))
+    }, Math.max(1, timeout) * 1000)
+    if (typeof timer.unref === 'function') timer.unref()
+    signal?.addEventListener?.('abort', onAbort, { once: true })
+
+    child.stderr?.on('data', (chunk) => {
+      if (stderr.length < 2000) stderr += chunk
+    })
+    child.on('error', (error) => finish(reject, Object.assign(error, { code: 'approve_failed' })))
+    child.on('close', (code) => {
+      if (code === 0) finish(resolve, true)
+      else finish(resolve, false)
+      void stderr
+    })
+    // инструмент может не читать stdin и выйти сразу — это не ошибка
+    child.stdin.on('error', () => {})
+    try {
+      // диалогу нужен человеческий текст; JSON отдаём переменными окружения
+      child.stdin.end(usesStdin(tool) ? String(prompt) : String(payload))
+    } catch {}
+  })
+}

package/lib/ask.mjs

@@ -0,0 +1,17 @@
+/**
+ * Подпись вопроса для интерактивного ввода.
+ *
+ * Значение по умолчанию показывается в квадратных скобках — но только если оно
+ * уже не показано в самом тексте вопроса. Иначе получается «...[user] [user]»,
+ * что и случилось на первом запуске мастера.
+ *
+ * @param {string} question текст вопроса
+ * @param {string} [fallback] значение по умолчанию
+ * @returns {string} строка с двоеточием на конце
+ */
+export function formatQuestion (question, fallback) {
+  const text = String(question ?? '').trim()
+  const hasBracketDefault = /\[[^\]]*\]\s*$/.test(text)
+  const suffix = fallback && !hasBracketDefault ? ` [${fallback}]` : ''
+  return `${text}${suffix}: `
+}

package/lib/autostart.mjs

@@ -0,0 +1,311 @@
+/**
+ * `dshnc autostart`: вопросы, юнит systemd, установка.
+ *
+ * Юнит собирается отдельной функцией, потому что ошибиться в systemd легко и
+ * молча: не тот target, забытый `User=`, запуск в графической сессии без
+ * переменных окружения. Текст юнита проверяется тестами, а не глазами.
+ *
+ * @module dsh-node-client/autostart
+ */
+import { spawnSync } from 'node:child_process'
+import { chmodSync, copyFileSync, cpSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+
+import { t } from './i18n.mjs'
+
+/** Где живёт user-юнит и системный юнит. */
+export const USER_UNIT_DIR = join(homedir(), '.config', 'systemd', 'user')
+export const SYSTEM_UNIT_DIR = '/etc/systemd/system'
+
+/**
+ * Текст юнита.
+ * @param {object} options
+ * @param {'user'|'system'} options.scope
+ * @param {string} options.execStart абсолютный путь к dshnc
+ * @param {string[]} [options.args] аргументы (по умолчанию `daemon`)
+ * @param {string} [options.user] `User=` для системного юнита
+ * @param {string} [options.home] домашний каталог (для `Environment=HOME=`)
+ * @param {boolean} [options.graphical] стартовать внутри графической сессии
+ * @param {string} [options.shell] DSHNC_SHELL
+ * @param {number} [options.restartSec]
+ * @returns {string}
+ */
+export function renderUnit ({ scope, execStart, args = ['daemon'], user, home, graphical = false, shell = '/bin/bash', restartSec = 5, pathEnv }) {
+  const lines = ['[Unit]', `Description=${t('unit.description')}`]
+  if (scope === 'system') {
+    lines.push('After=network-online.target', 'Wants=network-online.target')
+  } else if (graphical) {
+    // запускаемся вместе с графической сессией и забираем её окружение
+    lines.push('After=graphical-session.target', 'PartOf=graphical-session.target', 'Wants=graphical-session.target')
+  } else {
+    lines.push('After=network-online.target', 'Wants=network-online.target')
+  }
+  lines.push('', '[Service]')
+  if (scope === 'system') {
+    if (user) lines.push(`User=${user}`)
+    if (home) lines.push(`Environment=HOME=${home}`)
+  }
+  // У юнита свой PATH: node из nvm туда не попадает, и `env: 'node'` падает
+  lines.push(`Environment=PATH=${pathEnv ?? '/usr/local/bin:/usr/bin:/bin'}`)
+  lines.push(`Environment=DSHNC_SHELL=${shell}`)
+  if (scope === 'user' && graphical) {
+    // без этого DISPLAY/XAUTHORITY в user-юните пустые
+    lines.push("ExecStartPre=-/bin/sh -c 'systemctl --user import-environment DISPLAY XAUTHORITY WAYLAND_DISPLAY XDG_RUNTIME_DIR 2>/dev/null || true'")
+  }
+  lines.push(
+    `ExecStart=${execStart} ${args.join(' ')}`.trim(),
+    // перечитать конфиг без разрыва соединений: `systemctl --user reload dshnc`
+    'ExecReload=/bin/kill -HUP $MAINPID',
+    'Restart=always',
+    `RestartSec=${restartSec}`,
+    '',
+    '[Install]',
+    `WantedBy=${scope === 'user' && graphical ? 'graphical-session.target' : 'default.target'}`,
+  )
+  return lines.join('\n') + '\n'
+}
+
+/**
+ * Чем на самом деле запускать: если нас вызвали как `node …/dshnc.mjs`, то
+ * `ExecStart` должен нести интерпретатор и скрипт — на `.mjs` из юнита systemd
+ * не запустит по shebang.
+ * @param {string} script путь из `process.argv[1]`
+ * @param {string} [execPath] путь к node (`process.execPath`)
+ */
+export function resolveExecStart (script, execPath = process.execPath) {
+  if (!script) return execPath
+  return script.endsWith('.mjs') ? `${execPath} ${script}` : script
+}
+
+/** Имя файла юнита. */
+export function unitFileName (scope, name = 'dshnc') {
+  return `${name}.service`
+}
+
+/** Путь к файлу юнита. */
+export function unitPath (scope, name = 'dshnc', dir) {
+  const base = dir ?? (scope === 'user' ? USER_UNIT_DIR : SYSTEM_UNIT_DIR)
+  return join(base, unitFileName(scope, name))
+}
+
+/**
+ * Записать юнит.
+ * @returns {string} путь
+ */
+export function writeUnit ({ scope, name = 'dshnc', text, dir }) {
+  const path = unitPath(scope, name, dir)
+  mkdirSync(join(path, '..'), { recursive: true })
+  writeFileSync(path, text, { mode: 0o644 })
+  return path
+}
+
+/** Команды, которые надо выполнить после записи файла. */
+export function installCommands ({ scope, name = 'dshnc', graphUser }) {
+  if (scope === 'user') {
+    const prefix = graphUser ? `sudo -u ${graphUser} -i ` : ''
+    return [
+      ...(graphUser ? [] : ['systemctl --user daemon-reload']),
+      `${prefix}systemctl --user enable --now ${name}`,
+      `${prefix}systemctl --user status ${name} --no-pager`,
+    ]
+  }
+  return [
+    'sudo systemctl daemon-reload',
+    `sudo systemctl enable --now ${name}`,
+    `sudo systemctl status ${name} --no-pager`,
+  ]
+}
+
+/** Есть ли у нас право создавать системных пользователей без вопросов. */
+export function canCreateUsers ({ uid = process.getuid?.() ?? -1, hasSudo = false } = {}) {
+  return uid === 0 || hasSudo
+}
+
+/**
+ * Создать системного пользователя. Если мы root — сами, если есть sudo — через
+ * него, иначе возвращаем false: тогда мастер покажет команду и подождёт.
+ * @param {object} options
+ * @param {string} options.user
+ * @param {string} [options.home]
+ * @param {number} [options.uid]
+ * @param {boolean} [options.hasSudo]
+ * @param {(file: string, args: string[]) => {status: number|null}} [options.run]
+ * @returns {boolean}
+ */
+export function createUser ({ user, home = `/home/${user}`, uid = process.getuid?.() ?? -1, hasSudo = false, run }) {
+  const args = ['--system', '--create-home', '--home-dir', home, '--shell', '/usr/sbin/nologin', user]
+  const exec = run ?? ((file, argv) => spawnSync(file, argv, { stdio: 'inherit' }))
+  if (uid === 0) return exec('useradd', args).status === 0
+  if (hasSudo) return exec('sudo', ['-n', 'useradd', ...args]).status === 0
+  return false
+}
+
+/**
+ * Перенести состояние клиента другому пользователю.
+ * @param {object} options
+ * @param {string} options.from каталог-источник
+ * @param {string} options.to каталог-назначение
+ * @param {string} options.user владелец
+ * @param {number} [options.uid]
+ * @param {boolean} [options.hasSudo]
+ * @param {(file: string, args: string[]) => {status: number|null}} [options.run]
+ * @returns {boolean}
+ */
+export function copyState ({ from, to, user, uid = process.getuid?.() ?? -1, hasSudo = false, run }) {
+  const exec = run ?? ((file, argv) => spawnSync(file, argv, { stdio: 'inherit' }))
+  try {
+    mkdirSync(to, { recursive: true, mode: 0o700 })
+    for (const file of readdirSync(from)) {
+      if (file === 'node_modules') continue
+      const source = join(from, file)
+      const target = join(to, file)
+      const stat = statSync(source)
+      if (stat.isDirectory()) {
+        cpSync(source, target, { recursive: true })
+      } else {
+        copyFileSync(source, target)
+        chmodSync(target, file === 'config.json' ? 0o600 : stat.mode & 0o777)
+      }
+    }
+  } catch (error) {
+    return false
+  }
+  const argv = ['-R', `${user}:${user}`, to]
+  const result = uid === 0 ? exec('chown', argv) : hasSudo ? exec('sudo', ['-n', 'chown', ...argv]) : { status: 1 }
+  return result.status === 0
+}
+
+/** Команда создания пользователя, которую можно показать человеку. */
+export function createUserCommand (user, home = `/home/${user}`) {
+  return `sudo useradd --system --create-home --home-dir ${home} --shell /usr/sbin/nologin ${user}`
+}
+
+/** Существует ли пользователь. */
+export function userExists (user) {
+  try {
+    return readFileSync('/etc/passwd', 'utf8').split('\n').some((line) => line.startsWith(`${user}:`))
+  } catch {
+    return false
+  }
+}
+
+/** Каталог состояния пользователя. */
+export function stateDirFor ({ scope, user, home }) {
+  if (scope === 'user' || !user) return join(homedir(), '.dshnc')
+  return join(home ?? `/home/${user}`, '.dshnc')
+}
+
+/**
+ * Мастер: задать вопросы, собрать юнит, записать его, показать команды установки.
+ *
+ * `ask` и `print` приходят снаружи — поэтому весь диалог проверяется тестом без
+ * терминала. Копирование состояния делается только когда для системного юнита
+ * создан отдельный пользователь: иначе он просто не найдёт токен.
+ *
+ * @param {object} options
+ * @param {(question: string, fallback?: string) => Promise<string>} options.ask
+ * @param {(line: string) => void} options.print
+ * @param {object} options.config состояние клиента (name, aliases, servers)
+ * @param {string} options.execStart путь к dshnc
+ * @param {(scope: string, name: string) => string} [options.unitFile] переопределить путь (тесты)
+ * @param {boolean} [options.hasSudo]
+ * @param {number} [options.uid]
+ */
+export async function runAutostart ({ ask, print, config, execStart, unitFile, hasSudo = false, uid = process.getuid?.() ?? -1, run, stateFrom, stateTo }) {
+  print(t('auto.title'))
+
+  const name = (await ask(t('auto.name'), config.name ?? '')).trim() || config.name
+  const aliasesRaw = await ask(t('auto.aliases'), (config.aliases ?? []).join(','))
+  const aliases = aliasesRaw.split(',').map((value) => value.trim()).filter(Boolean).slice(0, 8)
+
+  const scopeAnswer = (await ask(t('auto.scope'), 'user')).trim().toLowerCase()
+  const scope = scopeAnswer.startsWith('s') ? 'system' : 'user'
+
+  let user = null
+  let home = null
+  let graphical = false
+
+  if (scope === 'system') {
+    const dedicated = (await ask(t('auto.dedicated'), 'n')).trim().toLowerCase().startsWith('y')
+    if (dedicated) {
+      user = (await ask(t('auto.username'), 'dshnc')).trim() || 'dshnc'
+      home = `/home/${user}`
+      if (!userExists(user)) {
+        const command = createUserCommand(user, home)
+        if (canCreateUsers({ uid, hasSudo }) && createUser({ user, home, uid, hasSudo, run })) {
+          print(t('auto.userCreated', { user }))
+        } else {
+          print(t('auto.createUser'))
+          print('  ' + command)
+          await ask(t('auto.waitingUser', { user }))
+          for (let attempt = 0; attempt < 120 && !userExists(user); attempt++) {
+            await new Promise((resolve) => setTimeout(resolve, 500))
+          }
+        }
+      }
+    }
+  } else {
+    graphical = (await ask(t('auto.graphical'), 'n')).trim().toLowerCase().startsWith('y')
+  }
+
+  const pathEnv = [dirname(process.execPath), '/usr/local/bin', '/usr/bin', '/bin'].join(':')
+  const text = renderUnit({ scope, execStart, user, home: home ?? undefined, graphical, pathEnv, shell: process.env.DSHNC_SHELL ?? '/bin/bash' })
+  // проверить, что запускать есть что: иначе юнит уйдёт в цикл падений
+  const launcher = execStart.split(' ')[0]
+  if (!existsSync(launcher)) {
+    print(t('auto.noLauncher', { path: launcher }))
+  }
+  const path = unitFile ? unitFile(scope, 'dshnc') : unitPath(scope, 'dshnc')
+  if (unitFile) {
+    mkdirSync(join(path, '..'), { recursive: true })
+    writeFileSync(path, text, { mode: 0o644 })
+  } else {
+    writeUnit({ scope, text })
+  }
+  print(t('auto.written', { path }))
+
+  const stateDir = stateDirFor({ scope, user, home })
+  print(t('auto.stateDir', { dir: stateDir }))
+  let copied = null
+  if (scope === 'system' && user) {
+    const hasToken = Object.values(config.servers ?? {}).some((entry) => entry?.token)
+    if (!hasToken) {
+      // демон без токена бесполезен: говорим прямо, что делать
+      print(t('auto.noToken', { user }))
+    } else if ((await ask(t('auto.copyState', { dir: stateDir }), 'n')).trim().toLowerCase().startsWith('y')) {
+      copied = copyState({ from: stateFrom ?? home_of_config(), to: stateTo ?? stateDir, user, uid, hasSudo, run })
+      print(copied ? t('auto.copied', { dir: stateTo ?? stateDir }) : t('auto.copyFailed', { user, message: 'chown/copy' }))
+    } else {
+      print(t('auto.copySkip'))
+    }
+  }
+
+  const commands = installCommands({ scope, name: 'dshnc' })
+  print('')
+  print(t('auto.next'))
+  for (const command of commands) print('  ' + command)
+  print('')
+  print(t('auto.done'))
+
+  return { name, aliases, scope, user, home, graphical, path, text, commands, stateDir, copied }
+}
+
+/** Каталог состояния текущего пользователя. */
+export function home_of_config () {
+  return join(homedir(), '.dshnc')
+}
+
+/** Применить ответы к конфигу клиента. */
+export function applyAutostartAnswers (config, { name, aliases }) {
+  if (name) config.name = name
+  config.aliases = aliasArray(aliases)
+  return config
+}
+
+/** Привести алиасы к массиву строк. */
+export function aliasArray (value) {
+  if (Array.isArray(value)) return value.map((item) => String(item).trim()).filter(Boolean)
+  if (typeof value === 'string') return value.split(',').map((item) => item.trim()).filter(Boolean)
+  return []
+}