@getxflow/cli 0.1.9 → 0.1.10

package/README.md

@@ -1,45 +1,45 @@
-# @getxflow/cli
-
-CLI for the [XFlow](https://getxflow.com) platform: source sync, builds and releases.
-
-```bash
-npm i -g @getxflow/cli
-xflow login
-xflow init my-app
-cd my-app && npm install
-xflow deploy
-xflow publish
-```
-
-Requires Node 20+. The package has no dependencies: it holds an access key, and nobody
-else's code belongs next to it.
-
-| Command | What it does |
-|---|---|
-| `login` / `logout` / `whoami` | sign in through the browser, sign out, whose key this is and what it can do |
-| `init` / `link` | new project, link a folder to an existing one |
-| `status` / `push` / `pull` | state, sending and fetching sources |
-| `deploy` / `publish` / `rollback` / `deployments` | build, publish, roll back, version history |
-| `db status` / `db migrate` | migrations from `migrations/*.sql` with a gate on destructive ones |
-| `functions list` / `functions deploy` | cloud functions of the project from `functions/<name>/index.ts` |
-| `functions invoke` / `functions logs` | call a function, look at its crashes with the stack |
-| `schedules list` / `set` / `rm` | running functions on a timer (timer triggers) |
-| `env` / `env check` / `env set` | environment variables of the functions, values are never handed back |
-| `logs` | browser errors from the released application |
-| `projects list` / `projects get` / `open` | projects of the organization and the application addresses |
-| `skills` | platform instructions for an AI agent ([Agent Skills](https://agentskills.io) format) |
-| `mcp install` | connect the agent to the platform directly, without a terminal |
-
-Help for one command: `xflow help <command>`.
-
-You write the application yourself or with your agent: the platform stays out of the code.
-`xflow skills` puts a description of the platform alongside it, which Claude Code, Codex and
-OpenClaw pick up on their own when a task touches XFlow. Your `AGENTS.md` and `CLAUDE.md` are
-left alone.
-
-`xflow mcp install` connects the agent to the platform directly: the database, migrations,
-functions, schedules, variables and versions become its tools, with no command output to parse.
-Code, builds and releases stay in the CLI.
-
-The key is stored in `~/.xflow/credentials.json`, the project configuration in `xflow.json`.
-For CI, pass the key in the `XFLOW_TOKEN` variable.
+# @getxflow/cli
+
+CLI for the [XFlow](https://getxflow.com) platform: source sync, builds and releases.
+
+```bash
+npm i -g @getxflow/cli
+xflow login
+xflow init my-app
+cd my-app && npm install
+xflow deploy
+xflow publish
+```
+
+Requires Node 20+. The package has no dependencies: it holds an access key, and nobody
+else's code belongs next to it.
+
+| Command | What it does |
+|---|---|
+| `login` / `logout` / `whoami` | sign in through the browser, sign out, whose key this is and what it can do |
+| `init` / `link` | new project, link a folder to an existing one |
+| `status` / `push` / `pull` | state, sending and fetching sources |
+| `deploy` / `publish` / `rollback` / `deployments` | build, publish, roll back, version history |
+| `db status` / `db migrate` | migrations from `migrations/*.sql` with a gate on destructive ones |
+| `functions list` / `functions deploy` | cloud functions of the project from `functions/<name>/index.ts` |
+| `functions invoke` / `functions logs` | call a function, look at its crashes with the stack |
+| `schedules list` / `set` / `rm` | running functions on a timer (timer triggers) |
+| `env` / `env check` / `env set` | environment variables of the functions, values are never handed back |
+| `logs` | browser errors from the released application |
+| `projects list` / `projects get` / `open` | projects of the organization and the application addresses |
+| `skills` | platform instructions for an AI agent ([Agent Skills](https://agentskills.io) format) |
+| `mcp install` | connect the agent to the platform directly, without a terminal |
+
+Help for one command: `xflow help <command>`.
+
+You write the application yourself or with your agent: the platform stays out of the code.
+`xflow skills` puts a description of the platform alongside it, which Claude Code, Codex and
+OpenClaw pick up on their own when a task touches XFlow. Your `AGENTS.md` and `CLAUDE.md` are
+left alone.
+
+`xflow mcp install` connects the agent to the platform directly: the database, migrations,
+functions, schedules, variables and versions become its tools, with no command output to parse.
+Code, builds and releases stay in the CLI.
+
+The key is stored in `~/.xflow/credentials.json`, the project configuration in `xflow.json`.
+For CI, pass the key in the `XFLOW_TOKEN` variable.

package/dist/api.js

@@ -10,9 +10,9 @@ class ApiError extends Error {
     code;
     status;
     hint;
-    /** Разбор отказа, если он есть: например, нарушения, из-за которых не пошла сборка. */
+    /** Check violations, e.g. why a build was rejected. */
     issues;
-    /** Заполнен, когда упёрлись в тариф: команда верна, повторять её бесполезно. */
+    /** Set when a plan limit was hit. */
     limit;
     constructor(message, code, status, hint, issues, limit) {
         super(message);
@@ -26,7 +26,7 @@ class ApiError extends Error {
 }
 exports.ApiError = ApiError;
 const DEFAULT_TIMEOUT_MS = 30_000;
-/** Заливка и скачивание архивов: десятки мегабайт по обычному домашнему каналу. */
+/** Archive uploads and downloads. */
 const TRANSFER_TIMEOUT_MS = 5 * 60_000;
 function parseVersion(value) {
     return value
@@ -58,13 +58,11 @@ async function send(client, path, options = {}) {
         'X-Xflow-Cli': version_1.CLI_VERSION,
         ...headers,
     };
-    // Вход по device flow идёт без ключа: пустой Bearer выглядел бы как испорченный.
     if (client.token)
         requestHeaders.Authorization = `Bearer ${client.token}`;
     let payload;
     if (Buffer.isBuffer(body)) {
-        // Именно ArrayBuffer: Buffer живёт в общем пуле Node, и его срез — это чужие
-        // байты вокруг наших. Плюс тип понятен и DOM-, и node-типизации fetch.
+        // Copy out of Node's shared Buffer pool before handing the bytes to fetch.
         payload = body.buffer.slice(body.byteOffset, body.byteOffset + body.byteLength);
         requestHeaders['Content-Type'] = requestHeaders['Content-Type'] ?? 'application/zip';
     }
@@ -104,18 +102,16 @@ async function apiJson(client, path, options = {}) {
         throw await readError(response);
     return (await response.json());
 }
-/** Ответ-файл: архив шаблона отдаётся телом, а не ссылкой (он лежит в базе, а не в S3). */
 async function apiBinary(client, path) {
     const response = await send(client, path, { timeoutMs: TRANSFER_TIMEOUT_MS });
     if (!response.ok)
         throw await readError(response);
     return Buffer.from(await response.arrayBuffer());
 }
-/** Загрузка архива на сервер: тот же разбор ошибок, но с длинным таймаутом. */
 async function apiUpload(client, path, body, headers = {}) {
     return apiJson(client, path, { method: 'POST', body, headers, timeoutMs: TRANSFER_TIMEOUT_MS });
 }
-/** Скачивание по подписанной ссылке. Ключ сюда не подставляем: ссылка сама и есть пропуск. */
+/** Signed URL download: no Authorization header attached. */
 async function downloadUrl(url) {
     let response;
     try {

package/dist/args.js

@@ -1,19 +1,11 @@
 "use strict";
-/**
- * Разбор аргументов.
- *
- * Своими руками, без зависимостей: пакет с ключом доступа внутри не должен
- * тянуть за собой чужой код ради двадцати строк логики.
- */
+/** Argument parsing, dependency-free. */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseArgs = parseArgs;
 exports.flagString = flagString;
 exports.flagBool = flagBool;
 exports.flagNumber = flagNumber;
-/**
- * Флаги без значения. Список явный, потому что иначе `--force ./dir` съедает
- * путь как значение флага, и разработчик получает загадочную ошибку.
- */
+/** Flags that never take a value, so `--force ./dir` keeps the path as a word. */
 const BOOLEAN_FLAGS = new Set([
     'force',
     'yes',

package/dist/bin.js

@@ -21,7 +21,6 @@ const schedules_1 = require("./commands/schedules");
 const skills_1 = require("./commands/skills");
 const sources_1 = require("./commands/sources");
 const deploy_1 = require("./commands/deploy");
-/** Одно место, где команда превращается в действие. Слова, а не флаги: `projects list`. */
 async function run(args) {
     const [first, second] = args.words;
     const rest = { ...args, words: args.words.slice(1) };
@@ -174,7 +173,6 @@ async function main() {
     catch (e) {
         if (e instanceof api_1.ApiError) {
             (0, ui_1.fail)(e.message);
-            // Отказ по тарифу помечаем явно: иначе агент правит команду, которая верна.
             if (e.limit)
                 (0, ui_1.note)((0, ui_1.dim)(`  ${(0, limits_1.limitLine)(e.limit)}`));
             if (e.hint)
@@ -189,7 +187,6 @@ async function main() {
             return 1;
         }
         (0, ui_1.fail)(e instanceof Error ? e.message : String(e));
-        // Стек прячем: он полезен только нам, и то по запросу.
         if (process.env.XFLOW_DEBUG && e instanceof Error && e.stack)
             (0, ui_1.note)((0, ui_1.dim)(e.stack));
         return 1;

package/dist/commands/auth.js

@@ -23,17 +23,11 @@ function localConfig() {
     }
 }
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-/**
- * Вход человека: device flow.
- *
- * Ключ не проходит ни через копипаст, ни через контекст агента — он выпускается
- * на сервере после подтверждения в браузере и приезжает сюда ровно один раз.
- */
+/** Device flow: the key is issued after confirmation in the browser, never typed. */
 async function login() {
     const config = localConfig();
     const client = (0, session_1.anonymous)(config);
-    // Имя машины уходит на сервер и становится названием ключа: иначе в списке
-    // доступов лежат одинаковые строки и непонятно, какой компьютер отзывать.
+    // The machine name becomes the key label on the platform.
     const start = await (0, api_1.apiJson)(client, '/api/v1/auth/device', {
         method: 'POST',
         body: { client_name: (0, node_os_1.hostname)() },
@@ -43,9 +37,19 @@ async function login() {
     (0, ui_1.note)(`  Computer:          ${(0, node_os_1.hostname)()}`);
     (0, ui_1.note)(`  Sign-in link:      ${start.verification_uri_complete}`);
     (0, ui_1.note)('');
-    // Браузер не открываем сами: команду часто запускает агент, и всплывшее окно
-    // забирает у человека внимание, не объяснив, что он подтверждает.
     (0, ui_1.step)('Open the link and check the code on the page against the one above');
+    const stopOffer = (0, ui_1.offerBrowser)(start.verification_uri_complete);
+    if (process.stdin.isTTY)
+        (0, ui_1.note)((0, ui_1.dim)('  Or press ENTER to open it in the browser'));
+    try {
+        await awaitConfirmation(client, start);
+    }
+    finally {
+        stopOffer();
+    }
+}
+/** Poll until the code is confirmed or expires. */
+async function awaitConfirmation(client, start) {
     const deadline = Date.now() + start.expires_in * 1000;
     let intervalMs = Math.max(start.interval, 1) * 1000;
     for (;;) {
@@ -61,7 +65,7 @@ async function login() {
             });
         }
         catch (e) {
-            // Слишком частый опрос — не повод прерывать вход, замедляемся.
+            // Slow down on rate limits instead of failing the sign-in.
             if (e instanceof api_1.ApiError && e.code === 'rate_limited') {
                 intervalMs = Math.min(intervalMs * 2, 30_000);
                 continue;
@@ -88,7 +92,7 @@ function logout() {
         (0, ui_1.warn)(`There is no stored key for ${apiUrl}`);
     }
 }
-/** Приписка к тарифу. У живой подписки её нет: молчание и значит «всё в порядке». */
+/** Suffix for a non-active subscription. */
 const SUBSCRIPTION_STATE = {
     past_due: ', the period has ended',
     suspended: ', work is suspended',
@@ -101,7 +105,8 @@ async function whoami() {
     (0, ui_1.out)(`Organization: ${me.organization.name ?? me.organization.id}`);
     (0, ui_1.out)(`Key:          xfk_${me.key.prefix}… (${me.key.scopes.join(', ')})`);
     (0, ui_1.out)(`Platform:     ${client.apiUrl}`);
-    if (process.env.XFLOW_TOKEN) {
+    // Same condition as in connect: for an address out of xflow.json the env key is ignored.
+    if (process.env.XFLOW_TOKEN?.trim() && client.apiUrl === (0, config_1.apiUrlFor)()) {
         (0, ui_1.note)((0, ui_1.dim)('  The key comes from XFLOW_TOKEN, the one stored in ~/.xflow is not used'));
     }
     else if (!(0, credentials_1.readCredential)(client.apiUrl)) {

package/dist/commands/db.js

@@ -11,18 +11,12 @@ const config_1 = require("../config");
 const errors_1 = require("../errors");
 const session_1 = require("../session");
 const ui_1 = require("../ui");
-/**
- * Миграции базы проекта.
- *
- * Файлы лежат в репозитории (`migrations/0001_init.sql`), историю применённых
- * помнит сама база. Отсюда правило: локально мы только читаем и сортируем, а что
- * из этого новое, решает сервер.
- */
+/** Migration files live in the repo; the applied history lives in the database. */
 const MIGRATIONS_DIR = 'migrations';
 function checksum(sql) {
     return (0, node_crypto_1.createHash)('sha256').update(sql).digest('hex').slice(0, 16);
 }
-/** Порядок по имени файла: `0001_` идёт раньше `0002_`, это и есть очередь. */
+/** File-name order is the queue. */
 function readMigrations(root) {
     const dir = (0, node_path_1.join)(root, MIGRATIONS_DIR);
     if (!(0, node_fs_1.existsSync)(dir))
@@ -68,8 +62,7 @@ async function dbStatus() {
             (0, ui_1.formatAge)(row.applied_at),
         ]);
     }
-    // Применённое, чего нет локально: чаще всего чужая миграция из другого проекта
-    // на той же логической базе.
+    // Applied but missing locally: usually another project on the same logical database.
     const localNames = new Set(local.map((migration) => migration.name));
     for (const row of history.applied) {
         if (!localNames.has(row.name))

package/dist/commands/deploy.js

@@ -12,18 +12,9 @@ const session_1 = require("../session");
 const ui_1 = require("../ui");
 const sources_1 = require("./sources");
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-/**
- * Потолок ожидания сборки в терминале. Чуть больше, чем срок, после которого
- * платформа закрывает молчащую сборку: так разработчик увидит внятный отказ, а
- * не «идёт дольше ожидаемого» на сборке, которую уже похоронили.
- */
+/** Slightly longer than the platform's own build timeout. */
 const WAIT_LIMIT_MS = 16 * 60_000;
-/**
- * Показать, чем проект не подошёл платформе.
- *
- * Печатаем весь список: правила известны заранее (скилл xflow), а узнавать их по
- * одному через повторные запуски значит терять круг на каждое нарушение.
- */
+/** Print every check violation at once. */
 function reportIssues(e) {
     const issues = e.issues ?? [];
     for (const issue of issues) {
@@ -33,13 +24,7 @@ function reportIssues(e) {
     }
     throw new errors_1.CliError(e.message, e.hint);
 }
-/**
- * Дождаться конца сборки, печатая фазы.
- *
- * Платформа отвечает на запуск сразу и не держит соединение: сборка живёт в
- * песочнице и переживает перезапуск платформы, поэтому её состояние забирается
- * опросом, а не потоком.
- */
+/** Poll the build until it finishes, printing phases. */
 async function waitForBuild(client, projectId, started) {
     const deadline = Date.now() + WAIT_LIMIT_MS;
     let shown = '';

package/dist/commands/env.js

@@ -13,9 +13,9 @@ const errors_1 = require("../errors");
 const session_1 = require("../session");
 const ui_1 = require("../ui");
 const FUNCTIONS_DIR = 'functions';
-/** Что функции просят у окружения: `process.env.NAME` и `process.env['NAME']`. */
+/** Matches `process.env.NAME` and `process.env['NAME']`. */
 const ENV_REFERENCE = /process\.env(?:\.([A-Z0-9_]+)|\[['"]([A-Z0-9_]+)['"]\])/g;
-/** Свои переменные платформа кладёт сама, спрашивать их у пользователя незачем. */
+/** Set by the platform itself. */
 const PROVIDED = new Set([
     'XFLOW_PROJECT_ID',
     'XFLOW_PROJECT_TOKEN',
@@ -37,7 +37,7 @@ function sourceFiles(dir, found = []) {
     }
     return found;
 }
-/** Какие переменные упоминают функции проекта, и в какой из них. */
+/** Which variables the project's functions read, and in which of them. */
 function referencedByFunctions(root) {
     const needed = new Map();
     const provided = new Map();
@@ -73,12 +73,7 @@ async function envList() {
     (0, ui_1.table)(rows.map((row) => [row.name, row.scope === 'project' ? 'this project only' : 'the whole organization']));
     (0, ui_1.note)((0, ui_1.dim)('  The platform never returns values: they are visible only inside the function'));
 }
-/**
- * Сверить, хватает ли функциям переменных.
- *
- * Это ответ на самый частый способ потерять полчаса: функция выкатилась, а падает
- * на пустом process.env, потому что переменную забыли записать наверх.
- */
+/** Check that every referenced variable is stored. */
 async function envCheck() {
     const { names, root } = await fetchVariables();
     const { needed, provided } = referencedByFunctions(root);
@@ -86,9 +81,6 @@ async function envCheck() {
         (0, ui_1.note)('The functions of this project read no environment variables');
         return;
     }
-    // Платформенные показываем отдельной таблицей, а не молчим о них: раньше
-    // функция, читающая только DATABASE_URL, получала ответ «переменных не
-    // читают», то есть команда делала ложное утверждение о собственном коде.
     if (provided.size > 0) {
         (0, ui_1.out)((0, ui_1.bold)('Provided by the platform:'));
         (0, ui_1.table)([...provided.entries()].sort().map(([name, users]) => [name, users.join(', ')]));
@@ -131,8 +123,7 @@ async function envSet(args) {
         body: { name, value, scope: (0, args_1.flagString)(args, 'scope') === 'project' ? 'project' : 'organization' },
     });
     (0, ui_1.ok)(`${(0, ui_1.bold)(result.name)} stored (${result.scope === 'project' ? 'this project only' : 'the whole organization'})`);
-    // Значение попадает в функцию на выкатке, а не в момент записи: пока функцию
-    // не передеплоили, в её окружении лежит прежнее.
+    // Values reach a function on its next deploy.
     const users = referencedByFunctions(root).needed.get(name);
     if (users && users.length > 0) {
         (0, ui_1.note)((0, ui_1.dim)(`  For the value to arrive, redeploy: xflow functions deploy ${users.join(' && xflow functions deploy ')}`));

package/dist/commands/functions.js

@@ -13,7 +13,6 @@ const session_1 = require("../session");
 const template_1 = require("../template");
 const ui_1 = require("../ui");
 const ENTRY_NAMES = ['index.ts', 'index.js', 'index.mjs'];
-/** Папка с функциями внутри проекта. Та же, что была до пивота: менять её незачем. */
 const FUNCTIONS_DIR = 'functions';
 function entryFor(root, name) {
     for (const entry of ENTRY_NAMES) {
@@ -33,14 +32,8 @@ function discover(root) {
         .sort();
 }
 /**
- * Собрать функцию в один файл.
- *
- * esbuild берём из node_modules проекта, а не тащим зависимостью в CLI: он и так
- * есть в каждом приложении на платформе (внутри Vite), а пакет без зависимостей
- * ставится быстрее и не требует доверия к нашему списку.
- *
- * `pg` оставляем снаружи бандла сознательно: серверная обёртка подставляет схему
- * проекта в каждое соединение, а сделать это можно только с общим драйвером.
+ * Bundle a function into one file. esbuild comes from the project's node_modules;
+ * `pg` stays external so the server wrapper can inject the project schema.
  */
 function bundle(root, entry) {
     let esbuild;
@@ -80,18 +73,10 @@ async function functionsList() {
         fn.error_message ?? '',
     ]));
 }
-/**
- * Записать адреса функций в `.env`, откуда их заберёт сборщик.
- *
- * Подставляем на сборке, а не спрашиваем у платформы в рантайме: иначе каждый
- * запуск приложения начинался бы с похода к нам, и мы стали бы обязательным
- * участником работы чужого приложения.
- */
+/** Write function URLs into .env, where the build picks them up. */
 async function refreshFunctionsEnv(root, client, projectId) {
     const card = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}`);
-    // Файла может не быть вовсе: в исходники он не уходит, а клон делают из git.
-    // Дописывать в такой один адрес функции бессмысленно — без токена вызов всё
-    // равно получит 401, поэтому восстанавливаем целиком, как это делает link.
+    // No .env at all (fresh clone): recreate it fully, like link does.
     if (!(0, node_fs_1.existsSync)((0, node_path_1.join)(root, '.env')) && card.project_token) {
         (0, node_fs_1.writeFileSync)((0, node_path_1.join)(root, '.env'), (0, template_1.envFile)(card.project_token, client.apiUrl, card.functions), 'utf-8');
     }
@@ -100,7 +85,6 @@ async function refreshFunctionsEnv(root, client, projectId) {
     }
     return card.functions.filter((fn) => fn.invoke_url).map((fn) => fn.name);
 }
-/** Ответ функции: JSON разворачиваем, прочее отдаём как есть. */
 function prettyBody(text) {
     try {
         return JSON.stringify(JSON.parse(text), null, 2);
@@ -109,12 +93,7 @@ function prettyBody(text) {
         return text;
     }
 }
-/**
- * Вызвать функцию так же, как её вызывает приложение.
- *
- * Токен проекта берём из карточки на платформе, а не из локального `.env`: в
- * свежем клоне файла нет вовсе, а команда должна работать сразу после link.
- */
+/** Call a function the same way the application does. */
 async function functionsInvoke(args) {
     const { config } = (0, config_1.requireProject)();
     const client = (0, session_1.connect)(config);
@@ -141,8 +120,7 @@ async function functionsInvoke(args) {
                 'X-Project-Token': card.project_token ?? '',
             },
             body: sendsBody ? (data ?? '{}') : undefined,
-            // У функции свой потолок в 90 секунд: ждём чуть дольше, чтобы увидеть её
-            // собственный таймаут, а не свой.
+            // Wait past the function's own 90 s cap to see its timeout, not ours.
             signal: AbortSignal.timeout(100_000),
         });
     }

package/dist/commands/logs.js

@@ -8,7 +8,6 @@ const config_1 = require("../config");
 const session_1 = require("../session");
 const ui_1 = require("../ui");
 const DEFAULT_LIMIT = 10;
-/** Стек с хвостом консоли бывает длинным: показываем начало, оно и есть причина. */
 const STACK_MAX_LINES = 14;
 function stamp(iso) {
     const date = new Date(iso);
@@ -24,7 +23,7 @@ async function fetchLogs(source, name, args) {
     const data = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/logs?${query.toString()}`);
     return data.logs;
 }
-/** Свежее — внизу: так последняя ошибка оказывается перед глазами, а не уезжает вверх. */
+/** Newest at the bottom. */
 function render(rows) {
     for (const row of [...rows].reverse()) {
         const label = row.source === 'function' ? (row.function ?? 'function') : 'browser';

package/dist/commands/mcp.js

@@ -9,7 +9,7 @@ const args_1 = require("../args");
 const config_1 = require("../config");
 const session_1 = require("../session");
 const ui_1 = require("../ui");
-/** Клиенты, у которых есть своя команда для добавления сервера. */
+/** Clients with their own server-add command. */
 const CLIENTS = [
     {
         binary: 'claude',
@@ -24,26 +24,20 @@ const CLIENTS = [
             '--header',
             `Authorization: Bearer ${token}`,
         ],
-        // Повторный запуск должен обновлять запись, а не спотыкаться о неё: команду
-        // выполняют и после смены ключа, и после обновления пакета.
+        // Re-running must update the entry, not fail on it.
         reset: ['mcp', 'remove', 'xflow', '-s', 'local'],
     },
 ];
 const WINDOWS = process.platform === 'win32';
 /**
- * Запустить чужую программу.
- *
- * На Windows без оболочки не найти `.cmd`-обёртки, которыми ставятся все
- * консольные пакеты npm. А оболочка не экранирует аргументы, а склеивает их:
- * заголовок «Authorization: Bearer …» разваливается по пробелу. Поэтому на
- * Windows собираем строку сами и сами же расставляем кавычки.
+ * Windows needs a shell to resolve npm's .cmd shims, and the shell joins
+ * arguments instead of escaping them: quote by hand.
  */
 function quote(value) {
     return WINDOWS ? `"${value.replace(/"/g, '""')}"` : value;
 }
 function execute(binary, args) {
-    // Вывод чужой команды перехватываем, а не пропускаем на экран: клиенты любят
-    // напечатать добавленные заголовки целиком, вместе с ключом.
+    // Capture output: clients may echo the added header together with the key.
     const options = { encoding: 'utf-8' };
     return WINDOWS
         ? (0, node_child_process_1.spawnSync)([binary, ...args.map(quote)].join(' '), { ...options, shell: true })
@@ -53,7 +47,7 @@ function hasBinary(binary) {
     return execute(binary, ['--version']).status === 0;
 }
 async function mcpInstall(args) {
-    // Сервер общий для организации, поэтому команда работает и вне папки проекта.
+    // The server covers the organization: the command works outside a project folder too.
     const root = (0, config_1.findProjectRoot)();
     const client = (0, session_1.connect)(root ? (0, config_1.readConfig)(root) : undefined);
     const url = `${client.apiUrl.replace(/\/+$/, '')}/api/mcp`;
@@ -87,7 +81,6 @@ async function mcpInstall(args) {
         (0, ui_1.out)(`  address: ${url}`);
         (0, ui_1.out)(`  header: Authorization: Bearer <key>`);
     }
-    // Ключ печатаем только по явной просьбе: см. комментарий в шапке файла.
     if ((0, args_1.flagBool)(args, 'show-token')) {
         (0, ui_1.out)('');
         (0, ui_1.out)(`${(0, ui_1.bold)('Key')} ${client.token}`);

package/dist/commands/projects.js

@@ -16,7 +16,7 @@ const skills_1 = require("./skills");
 const template_1 = require("../template");
 const zip_1 = require("../zip");
 const ui_1 = require("../ui");
-/** Пустой ли каталог. `.git` не считается: связывать свежий клон — обычное дело. */
+/** .git alone does not count: linking a fresh clone is normal. */
 function isEmptyEnough(dir) {
     if (!(0, node_fs_1.existsSync)(dir))
         return true;
@@ -30,7 +30,7 @@ function write(root, path, content) {
 function escapeHtml(value) {
     return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
 }
-/** Заголовок вкладки в шаблоне общий на всех: у проекта он должен быть свой. */
+/** Give the project its own tab title. */
 function titleFromProject(path, content, name) {
     if (path !== 'index.html')
         return content;
@@ -46,17 +46,7 @@ async function templates() {
     }
     (0, ui_1.table)(list.map((t) => [t.id, t.name, t.is_default ? 'default' : '', t.description ?? '']));
 }
-/**
- * Создать проект: шаблон платформы, локальная папка, проект на платформе.
- *
- * Шаблон приезжает с платформы, а не лежит в этом пакете. Иначе появились бы две
- * стартовые точки — веб и CLI, — и приложения из них выглядели бы по-разному, хотя
- * платформа у них одна.
- *
- * Отсюда и порядок: проект заводится первым, потому что без него неоткуда взять
- * токен для `.env`. Если запись файлов сорвётся, проект останется пустым, и CLI
- * скажет, как его подобрать (`xflow link`), — молча оставлять сироту нельзя.
- */
+/** Create a project from the platform template. */
 async function init(args) {
     const target = (0, node_path_1.resolve)(args.words[0] ?? '.');
     const name = (0, args_1.flagString)(args, 'name') ?? (0, node_path_1.basename)(target);
@@ -107,7 +97,6 @@ async function init(args) {
     (0, ui_1.out)('    npm run dev        # develop');
     (0, ui_1.out)('    xflow deploy       # send the code, build and release');
 }
-/** Связать текущую папку с уже существующим проектом. */
 async function link(args) {
     const root = (0, config_1.findProjectRoot)() ?? process.cwd();
     const existing = (0, node_fs_1.existsSync)((0, node_path_1.join)(root, config_1.CONFIG_FILE)) ? (0, config_1.readConfig)(root) : undefined;
@@ -124,8 +113,7 @@ async function link(args) {
         build: existing?.build ?? { command: 'npm run build', dir: 'dist' },
     });
     (0, config_1.ignoreStateInGit)(dir);
-    // В исходники .env не уходит, поэтому в свежем клоне его нет вовсе, и приложение
-    // молча теряет доступ к облачным функциям. Восстанавливаем, но чужой не трогаем.
+    // A fresh clone has no .env: recreate it, never overwrite an existing one.
     if (!(0, node_fs_1.existsSync)((0, node_path_1.join)(dir, '.env')) && card.project_token) {
         write(dir, '.env', (0, template_1.envFile)(card.project_token, client.apiUrl, card.functions));
         (0, ui_1.note)((0, ui_1.dim)('  Created .env with the project token and the function addresses'));