@getxflow/cli 0.1.8 → 0.1.10

package/dist/session.js

@@ -5,22 +5,18 @@ exports.anonymous = anonymous;
 const config_1 = require("./config");
 const credentials_1 = require("./credentials");
 const errors_1 = require("./errors");
-/**
- * Соединение с платформой: адрес плюс ключ.
- *
- * Адрес берётся из XFLOW_API_URL, потом из xflow.json, потом умолчание —
- * порядок такой, чтобы разработчик мог указать локальную платформу одной
- * переменной, не правя конфигурацию проекта.
- */
+/** Platform connection: address plus key. */
 function connect(config) {
     const apiUrl = (0, config_1.apiUrlFor)(config);
-    const token = (0, credentials_1.resolveToken)(apiUrl);
+    // XFLOW_TOKEN never follows an address taken from the repo's xflow.json:
+    // a cloned config must not be able to redirect the key elsewhere.
+    const token = (0, credentials_1.resolveToken)(apiUrl, apiUrl === (0, config_1.apiUrlFor)());
     if (!token) {
-        throw new errors_1.CliError(`Нет ключа доступа для ${apiUrl}`, 'Войдите: xflow login. В CI передайте ключ переменной XFLOW_TOKEN');
+        throw new errors_1.CliError(`No access key for ${apiUrl}`, 'Sign in: xflow login. In CI pass the key in the XFLOW_TOKEN variable');
     }
     return { apiUrl, token };
 }
-/** Соединение без ключа: только для входа. */
+/** Sign-in only. */
 function anonymous(config) {
     return { apiUrl: (0, config_1.apiUrlFor)(config), token: '' };
 }

package/dist/template.js

@@ -15,23 +15,23 @@ dist/
 `;
 const README = `# %NAME%
 
-Приложение на XFlow.
+An application on XFlow.
 
 \`\`\`bash
-npm install       # зависимости
-npm run dev       # разработка на localhost:3000
-xflow deploy      # отправить код и собрать на платформе
-xflow publish     # показать dev-версию посетителям
+npm install       # dependencies
+npm run dev       # develop on localhost:3000
+xflow deploy      # send the code and build it on the platform
+xflow publish     # show the dev version to visitors
 \`\`\`
 
-Интерфейс собран на компонентах шаблона: \`src/components/ui\` (кнопки, поля, диалоги)
-и \`src/components/blocks\` (таблица, форма, фильтры, канбан, графики). Своя вёрстка
-поверх них выглядит как остальная платформа, а собственные цвета вместо токенов из
-\`src/index.css\` эту связность ломают.
+The interface is built on the template components: \`src/components/ui\` (buttons, fields,
+dialogs) and \`src/components/blocks\` (table, form, filters, kanban, charts). Layout built
+on top of them looks like the rest of the platform, while custom colors in place of the
+tokens from \`src/index.css\` break that consistency.
 
-Полезное: \`xflow status\` — что на сервере, \`xflow deployments\` — история версий.
+Useful: \`xflow status\` for what is on the server, \`xflow deployments\` for version history.
 `;
-/** Адреса облачных функций для сборки: имя → URL, одной строкой JSON. */
+/** Function name → URL map, one JSON line. */
 exports.FUNCTIONS_ENV_KEY = 'VITE_XFLOW_FUNCTIONS';
 function functionsEnvValue(functions) {
     const map = {};
@@ -41,10 +41,7 @@ function functionsEnvValue(functions) {
     }
     return JSON.stringify(map);
 }
-/**
- * `.env` в исходники не уходит (его пропускают и push, и сервер), поэтому в свежем
- * клоне его восстанавливает `xflow link`.
- */
+/** .env is never pushed; xflow link recreates it in a fresh clone. */
 function envFile(projectToken, apiUrl, functions = []) {
     return [
         `VITE_XFLOW_PROJECT_TOKEN=${projectToken}`,
@@ -53,12 +50,7 @@ function envFile(projectToken, apiUrl, functions = []) {
         '',
     ].join('\n');
 }
-/**
- * Обновить одну переменную в `.env`, не трогая остальные.
- *
- * Файл наш, но живёт у разработчика: рядом с нашими тремя строками у него может
- * лежать что угодно своё, и переписывать файл целиком мы не вправе.
- */
+/** Update one variable in .env without touching the rest of the file. */
 function writeEnvValue(root, key, value) {
     const path = (0, node_path_1.join)(root, '.env');
     const line = `${key}=${value}`;

package/dist/tree.js

@@ -7,12 +7,7 @@ exports.heaviest = heaviest;
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-/**
- * Не отправляется никогда. Первые пять сервер отклоняет и сам, но узнать об
- * этом лучше до заливки 200 МБ node_modules. Секреты (`.env*`) шире серверного
- * списка сознательно: значения переменных живут в настройках организации,
- * а не в репозитории.
- */
+/** Never sent. */
 const DEFAULT_IGNORE = [
     'node_modules/',
     '.git/',
@@ -60,7 +55,7 @@ function compileRule(raw) {
     const suffix = dirOnly ? '/' : '($|/)';
     return { re: new RegExp(`${prefix}${source}${suffix}`) };
 }
-/** Правила исключения: умолчания, файл .xflowignore и поле ignore в xflow.json. */
+/** Defaults, the .xflowignore file and the ignore field of xflow.json. */
 function loadIgnoreRules(root, extra = []) {
     const lines = [...DEFAULT_IGNORE, ...extra];
     const ignoreFile = (0, node_path_1.join)(root, IGNORE_FILE);
@@ -73,7 +68,7 @@ function isIgnored(relativePath, rules, isDirectory) {
     const probe = isDirectory ? `${relativePath}/` : relativePath;
     return rules.some((rule) => rule.re.test(probe));
 }
-/** Двоичный файл: ищем нулевой байт в начале, как это делает git. */
+/** NUL byte in the head, same heuristic as git. */
 function isBinary(content) {
     const limit = Math.min(content.length, 8000);
     for (let i = 0; i < limit; i++) {
@@ -82,12 +77,7 @@ function isBinary(content) {
     }
     return false;
 }
-/**
- * Приводим переводы строк к LF.
- *
- * Иначе одно и то же дерево на Windows и на Linux даёт разные хеши, и статус
- * вечно показывает изменения, которых никто не делал. Двоичные файлы не трогаем.
- */
+/** CRLF and LF must hash the same on every OS. Binary files stay untouched. */
 function normalizeEol(content) {
     if (isBinary(content) || !content.includes(0x0d))
         return content;
@@ -100,8 +90,6 @@ function collectFiles(root, rules) {
         for (const entry of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })) {
             const full = (0, node_path_1.join)(dir, entry.name);
             const rel = (0, node_path_1.relative)(root, full).split(node_path_1.sep).join('/');
-            // Ссылки не отправляем: в архиве их не представить, а пойти по ним значит
-            // утащить чужое дерево целиком.
             if (entry.isSymbolicLink()) {
                 skippedLinks.push(rel);
                 continue;
@@ -123,13 +111,12 @@ function collectFiles(root, rules) {
     files.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
     return { files, skippedLinks };
 }
-/** Хеш дерева. Считается ровно так же на сервере — иначе push «менялось/не менялось» врал бы. */
+/** Computed identically on the server. */
 function treeHash(files) {
     const parts = files.map((file) => `${file.path}\0${(0, node_crypto_1.createHash)('sha256').update(file.content).digest('hex')}`);
     parts.sort();
     return (0, node_crypto_1.createHash)('sha256').update(parts.join('\n')).digest('hex');
 }
-/** Самые тяжёлые файлы: показываем их, когда архив не влез в лимит. */
 function heaviest(files, count = 5) {
     return [...files].sort((a, b) => b.content.length - a.content.length).slice(0, count);
 }

package/dist/types.js

@@ -1,10 +1,3 @@
 "use strict";
-/**
- * Ответы публичного API, которые разбирает CLI.
- *
- * Адресов собранного приложения здесь нет: платформа их наружу не отдаёт. В них
- * зашит номер версии, и после следующей публикации такая ссылка продолжает
- * отвечать старой копией, а не ломается. Версии называем номерами, ссылка одна
- * и ведёт на страницу проекта.
- */
+/** Public API responses parsed by the CLI. */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/ui.js

@@ -10,14 +10,13 @@ exports.fail = fail;
 exports.table = table;
 exports.formatBytes = formatBytes;
 exports.formatAge = formatAge;
+exports.offerBrowser = offerBrowser;
 exports.confirmWord = confirmWord;
+const node_child_process_1 = require("node:child_process");
 const node_readline_1 = require("node:readline");
 /**
- * Вывод CLI.
- *
- * Всё пишется через один модуль, а не через console: человек читает stdout,
- * машина парсит его же, а служебные сообщения (шаги, предупреждения) обязаны
- * уходить в stderr, иначе `xflow pull > file` сложит их в файл вместе с данными.
+ * All CLI output. Data goes to stdout, progress and warnings to stderr,
+ * so `xflow pull > file` captures data only.
  */
 const color = process.stdout.isTTY === true && !process.env.NO_COLOR;
 function paint(code, text) {
@@ -30,11 +29,9 @@ exports.dim = dim;
 const red = (t) => paint('31', t);
 const green = (t) => paint('32', t);
 const yellow = (t) => paint('33', t);
-/** Данные: то, ради чего команду запускали. */
 function out(line = '') {
     process.stdout.write(`${line}\n`);
 }
-/** Ход работы: шаги, предупреждения, ошибки. */
 function note(line = '') {
     process.stderr.write(`${line}\n`);
 }
@@ -50,7 +47,7 @@ function warn(message) {
 function fail(message) {
     note(red(`✗ ${message}`));
 }
-/** Таблица с выравниванием по колонкам. Заголовок не рисуем: он не нужен на 3 строки. */
+/** Column-aligned rows, no header. */
 function table(rows) {
     if (rows.length === 0)
         return;
@@ -66,44 +63,69 @@ function table(rows) {
 }
 function formatBytes(bytes) {
     if (bytes < 1024)
-        return `${bytes} Б`;
+        return `${bytes} B`;
     if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)} КБ`;
-    return `${(bytes / 1024 / 1024).toFixed(1)} МБ`;
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
 }
 function formatAge(iso) {
     if (!iso)
-        return '—';
+        return '-';
     const ms = Date.now() - new Date(iso).getTime();
     if (!Number.isFinite(ms) || ms < 0)
-        return '—';
+        return '-';
     const minutes = Math.floor(ms / 60000);
     if (minutes < 1)
-        return 'только что';
+        return 'just now';
     if (minutes < 60)
-        return `${minutes} мин назад`;
+        return `${minutes} min ago`;
     const hours = Math.floor(minutes / 60);
     if (hours < 24)
-        return `${hours} ч назад`;
-    return `${Math.floor(hours / 24)} дн назад`;
+        return `${hours} h ago`;
+    return `${Math.floor(hours / 24)} d ago`;
+}
+/** Open a link with the system handler. Failures are ignored: the link is already printed. */
+function openUrl(url) {
+    // The URL reaches a shell on Windows: allow only plain http(s) links.
+    if (!/^https?:\/\/[A-Za-z0-9.-]+(:\d+)?(\/[A-Za-z0-9._~/?=#-]*)?$/.test(url))
+        return;
+    const [command, args] = process.platform === 'win32'
+        ? ['cmd', ['/c', 'start', '', url]]
+        : process.platform === 'darwin'
+            ? ['open', [url]]
+            : ['xdg-open', [url]];
+    try {
+        (0, node_child_process_1.spawn)(command, args, { stdio: 'ignore', detached: true }).unref();
+    }
+    catch {
+        // No browser at all (ssh session): the user opens the link elsewhere.
+    }
 }
 /**
- * Подтверждение опасного действия.
- *
- * Требуем ввести конкретное слово, а не «y»: `--force` перетирает чужую работу,
- * и подтверждение должно стоить осознанного действия. В неинтерактивном режиме
- * (CI, запуск из агента) подтвердить нельзя вовсе — это сознательно (D23).
+ * Offer to open the link on Enter. TTY only, so agent-driven runs are unaffected.
+ * Non-blocking: polling continues, Enter is just a shortcut. Returns a cleanup.
  */
+function offerBrowser(url) {
+    if (!process.stdin.isTTY)
+        return () => { };
+    const rl = (0, node_readline_1.createInterface)({ input: process.stdin, output: process.stderr });
+    rl.on('line', () => {
+        openUrl(url);
+        rl.close();
+    });
+    return () => rl.close();
+}
+/** Dangerous-action confirmation: type the exact word. Unavailable without a TTY. */
 async function confirmWord(question, expected) {
     if (!process.stdin.isTTY) {
-        fail('Подтверждение возможно только в интерактивном терминале');
-        note((0, exports.dim)('  В CI это правильное поведение: расхождение версий должно ронять сборку, а не перетирать чужую работу'));
+        fail('Confirmation is only possible in an interactive terminal');
+        note((0, exports.dim)('  In CI this is the right behaviour: a version conflict has to fail the build rather than overwrite work that is not yours'));
         return false;
     }
     const rl = (0, node_readline_1.createInterface)({ input: process.stdin, output: process.stderr });
     try {
         const answer = await new Promise((resolve) => {
-            rl.question(`${question}\n  Введите «${expected}» для подтверждения: `, resolve);
+            rl.question(`${question}\n  Type "${expected}" to confirm: `, resolve);
         });
         return answer.trim() === expected;
     }

package/dist/version.js

@@ -1,11 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_API_URL = exports.CLI_VERSION = void 0;
-/**
- * Версия CLI. Держать синхронно с cli/package.json: читать package.json в
- * рантайме нельзя, после сборки он лежит на уровень выше dist и в бандл не
- * попадает.
- */
-exports.CLI_VERSION = '0.1.7';
-/** Адрес платформы по умолчанию. Переопределяется XFLOW_API_URL и полем `api` в xflow.json. */
+/** Keep in sync with cli/package.json. */
+exports.CLI_VERSION = '0.1.10';
+/** Overridden by XFLOW_API_URL or the `api` field in xflow.json. */
 exports.DEFAULT_API_URL = 'https://app.getxflow.com';

package/dist/zip.js

@@ -10,9 +10,8 @@ exports.ZipError = ZipError;
 const LOCAL_SIG = 0x04034b50;
 const CENTRAL_SIG = 0x02014b50;
 const EOCD_SIG = 0x06054b50;
-/** Флаг «имена в UTF-8»: без него кириллица в путях читается как мохибейк. */
 const FLAG_UTF8 = 0x0800;
-/** 1980-01-01 в формате DOS: время сборки в архив не пишем, чтобы он был воспроизводим. */
+/** Fixed timestamp keeps archives reproducible. */
 const DOS_DATE = 0x0021;
 const DOS_TIME = 0x0000;
 const CRC_TABLE = (() => {
@@ -47,13 +46,11 @@ function zipCreate(entries) {
     const locals = [];
     const centrals = [];
     let offset = 0;
-    // Порядок фиксируем: одно и то же дерево должно давать один и тот же архив.
+    // Same tree, same archive: fixed order.
     const sorted = [...entries].sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
     for (const entry of sorted) {
         const name = Buffer.from(entry.path, 'utf-8');
         const crc = crc32(entry.content);
-        // Сжимаем, но только если это что-то даёт: у уже сжатых файлов (png, zip)
-        // deflate добавляет байты, и хранение как есть честнее.
         const deflated = (0, node_zlib_1.deflateRawSync)(entry.content, { level: 6 });
         const compressed = deflated.length < entry.content.length;
         const method = compressed ? 8 : 0;
@@ -110,7 +107,7 @@ function zipCreate(entries) {
     return Buffer.concat([...locals, central, eocd]);
 }
 function findEocd(buffer) {
-    // Комментарий архива может занимать до 64 КБ, поэтому ищем сигнатуру с конца.
+    // The archive comment can be up to 64 KB long: scan from the end.
     const from = Math.max(0, buffer.length - 66_000);
     for (let i = buffer.length - 22; i >= from; i--) {
         if (buffer.readUInt32LE(i) === EOCD_SIG)
@@ -118,18 +115,25 @@ function findEocd(buffer) {
     }
     return -1;
 }
+/** Entries are written to disk by the caller: reject paths that escape the target. */
+function isSafeEntryPath(path) {
+    if (path.length === 0 || path.startsWith('/') || /^[A-Za-z]:/.test(path) || path.includes('\0')) {
+        return false;
+    }
+    return path.split('/').every((part) => part !== '' && part !== '.' && part !== '..');
+}
 function zipRead(buffer) {
     if (buffer.length < 22)
-        throw new ZipError('Файл слишком мал для zip');
+        throw new ZipError('The file is too small to be a zip');
     const eocd = findEocd(buffer);
     if (eocd === -1)
-        throw new ZipError('Это не zip: не найден конец архива');
+        throw new ZipError('This is not a zip: the end of the archive was not found');
     const count = buffer.readUInt16LE(eocd + 10);
     let pointer = buffer.readUInt32LE(eocd + 16);
     const entries = [];
     for (let i = 0; i < count; i++) {
         if (pointer + 46 > buffer.length || buffer.readUInt32LE(pointer) !== CENTRAL_SIG) {
-            throw new ZipError('Повреждён оглавление архива');
+            throw new ZipError('The archive directory is damaged');
         }
         const method = buffer.readUInt16LE(pointer + 10);
         const compressedSize = buffer.readUInt32LE(pointer + 20);
@@ -143,10 +147,10 @@ function zipRead(buffer) {
         if (name.endsWith('/'))
             continue;
         if (compressedSize === 0xffffffff || uncompressedSize === 0xffffffff) {
-            throw new ZipError(`Архив в формате zip64 не поддерживается: ${name}`);
+            throw new ZipError(`The zip64 format is not supported: ${name}`);
         }
-        if (buffer.readUInt32LE(localOffset) !== LOCAL_SIG) {
-            throw new ZipError(`Повреждена запись архива: ${name}`);
+        if (localOffset + 30 > buffer.length || buffer.readUInt32LE(localOffset) !== LOCAL_SIG) {
+            throw new ZipError(`A damaged archive entry: ${name}`);
         }
         const localNameLength = buffer.readUInt16LE(localOffset + 26);
         const localExtraLength = buffer.readUInt16LE(localOffset + 28);
@@ -161,13 +165,16 @@ function zipRead(buffer) {
                 content = (0, node_zlib_1.inflateRawSync)(raw);
             }
             catch (e) {
-                throw new ZipError(`Не удалось распаковать ${name}: ${e instanceof Error ? e.message : e}`);
+                throw new ZipError(`Could not unpack ${name}: ${e instanceof Error ? e.message : e}`);
             }
         }
         else {
-            throw new ZipError(`Неизвестный метод сжатия (${method}) у ${name}`);
+            throw new ZipError(`Unknown compression method (${method}) on ${name}`);
         }
-        entries.push({ path: name.replace(/\\/g, '/'), content });
+        const path = name.replace(/\\/g, '/');
+        if (!isSafeEntryPath(path))
+            throw new ZipError(`Unsafe path in the archive: ${name}`);
+        entries.push({ path, content });
     }
     return entries;
 }

package/package.json

@@ -1,22 +1,22 @@
-{
-  "name": "@getxflow/cli",
-  "version": "0.1.8",
-  "description": "CLI платформы XFlow: синхронизация кода, деплой и публикация приложений",
-  "license": "UNLICENSED",
-  "engines": {
-    "node": ">=20"
-  },
-  "bin": {
-    "xflow": "dist/bin.js"
-  },
-  "files": [
-    "dist",
-    "skills"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@getxflow/cli",
+  "version": "0.1.10",
+  "description": "CLI for the XFlow platform: source sync, deployment and publishing of applications",
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "xflow": "dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/xflow/SKILL.md

@@ -14,7 +14,25 @@ A platform project is recognized by the `xflow.json` file in its root.
 Check commands and flags against `xflow help` and `xflow help <command>`, not against
 memory. If a command is not in the help output, it does not exist: guessing flags is
 pointless. The CLI prints a hint with almost every error, read it in full, it usually
-contains the fix. Help output is in Russian.
+contains the fix.
+
+## Plan limits
+
+The organization runs on a plan with finite limits: projects, cloud functions, developer
+and staff seats, database and file storage, function minutes per month, plus the right to
+use schedules. `xflow whoami` prints every one of them next to what is already used, and
+reading it before a long task is cheaper than hitting a wall mid-way.
+
+A limit refusal is not a bad request. The CLI prints a line starting with `Plan limit:`,
+the API answers `code: "forbidden"` with a `limit` object (`code`, `used`, `limit`), and
+MCP tools carry the same field. Retrying the command, renaming things or rewriting the
+code changes nothing: tell the user what ran out and stop. Only the owner or an admin
+lifts it, in the web interface, by freeing the resource or moving to a bigger plan.
+
+One refusal looks like a code error but is not: when the database is over its plan size,
+Postgres itself rejects inserts (`db_write_locked`). Reads and deletes still work, so the
+fix is a migration that deletes data, never a rewrite of the failing SQL. Write is
+restored within an hour of the data going back under the limit.
 
 ## Workflow