@getxflow/cli 0.1.8 → 0.1.9

package/dist/limits.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Лимиты тарифа в выводе CLI.
+ *
+ * Два места, где они видны: `xflow whoami` (что есть) и отказ команды (во что
+ * упёрлись). Второе важнее: без явной пометки агент читает 403 как ошибку
+ * запроса и уходит переписывать команду, которая была верной.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.limitLine = limitLine;
+exports.quotaRows = quotaRows;
+/** Что кончилось, по коду отказа гейта. */
+const DENIAL_LABELS = {
+    limit_projects: 'projects',
+    limit_functions: 'cloud functions',
+    limit_builds: 'builds this month',
+    limit_seats: 'seats in the organization',
+    limit_schedule_interval: 'schedule frequency',
+    db_write_locked: 'database volume, writes are off',
+    plan_no_schedules: 'schedules',
+    subscription_blocked: 'the subscription is unpaid',
+    billing_unavailable: 'plan check',
+};
+/** Строка под сообщением отказа: почему повторять команду бесполезно. */
+function limitLine(detail) {
+    const label = DENIAL_LABELS[detail.code] ?? detail.code;
+    const numbers = detail.used !== undefined && detail.limit !== undefined
+        ? `, ${detail.used} of ${detail.limit} used`
+        : '';
+    return `Plan limit: ${label}${numbers}. Repeating the same command will not help.`;
+}
+/** Порядок строк в whoami: сперва штучное, потом объёмы, потом расход месяца. */
+const QUOTA_ORDER = [
+    'projects',
+    'functions',
+    'developers',
+    'members',
+    'database_mb',
+    'files_mb',
+    'function_minutes',
+    'builds',
+];
+const QUOTA_LABELS = {
+    projects: 'Projects',
+    functions: 'Cloud functions',
+    developers: 'Developers',
+    members: 'Staff',
+    database_mb: 'Database',
+    files_mb: 'Files',
+    function_minutes: 'Function minutes',
+    builds: 'Builds this month',
+};
+/** Гигабайт десятичный, 1000 МБ: так объём и продаётся, шаг докупки 500 МБ
+ *  обязан читаться как полгигабайта. Сравнение с байтами живёт на сервере и
+ *  остаётся на 1024². */
+function sizeLabel(mb) {
+    if (mb < 1000)
+        return `${Math.round(mb)} MB`;
+    const gb = mb / 1000;
+    return `${Number.isInteger(gb) ? String(gb) : gb.toFixed(1)} GB`;
+}
+function quotaValue(key, use) {
+    // Обе стороны в одних единицах: «0.2 of 15 GB» читается, «245 of 15360» нет.
+    if (key.endsWith('_mb')) {
+        const used = use.limit >= 1000 ? (use.used / 1000).toFixed(1) : String(use.used);
+        return `${used} of ${sizeLabel(use.limit)}`;
+    }
+    return `${use.used} of ${use.limit}`;
+}
+/** Строки таблицы для whoami. Незнакомые ключи не прячем: сервер мог добавить. */
+function quotaRows(quotas) {
+    const known = QUOTA_ORDER.filter((key) => quotas[key]);
+    const rest = Object.keys(quotas).filter((key) => !QUOTA_ORDER.includes(key));
+    return [...known, ...rest].map((key) => [
+        `  ${QUOTA_LABELS[key] ?? key}`,
+        quotaValue(key, quotas[key]),
+    ]);
+}

package/dist/session.js

@@ -16,7 +16,7 @@ function connect(config) {
     const apiUrl = (0, config_1.apiUrlFor)(config);
     const token = (0, credentials_1.resolveToken)(apiUrl);
     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 };
 }

package/dist/template.js

@@ -7,29 +7,29 @@ exports.writeEnvValue = writeEnvValue;
 exports.scaffoldFiles = scaffoldFiles;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const GITIGNORE = `node_modules/
-dist/
-.xflow/
-.env
-.env.*
+const GITIGNORE = `node_modules/
+dist/
+.xflow/
+.env
+.env.*
 `;
-const README = `# %NAME%
-
-Приложение на XFlow.
-
-\`\`\`bash
-npm install       # зависимости
-npm run dev       # разработка на localhost:3000
-xflow deploy      # отправить код и собрать на платформе
-xflow publish     # показать dev-версию посетителям
-\`\`\`
-
-Интерфейс собран на компонентах шаблона: \`src/components/ui\` (кнопки, поля, диалоги)
-и \`src/components/blocks\` (таблица, форма, фильтры, канбан, графики). Своя вёрстка
-поверх них выглядит как остальная платформа, а собственные цвета вместо токенов из
-\`src/index.css\` эту связность ломают.
-
-Полезное: \`xflow status\` — что на сервере, \`xflow deployments\` — история версий.
+const README = `# %NAME%
+
+An application on XFlow.
+
+\`\`\`bash
+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
+\`\`\`
+
+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.
+
+Useful: \`xflow status\` for what is on the server, \`xflow deployments\` for version history.
 `;
 /** Адреса облачных функций для сборки: имя → URL, одной строкой JSON. */
 exports.FUNCTIONS_ENV_KEY = 'VITE_XFLOW_FUNCTIONS';

package/dist/ui.js

@@ -66,26 +66,26 @@ 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`;
 }
 /**
  * Подтверждение опасного действия.
@@ -96,14 +96,14 @@ function formatAge(iso) {
  */
 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 somebody else"s work'));
         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

@@ -6,6 +6,6 @@ exports.DEFAULT_API_URL = exports.CLI_VERSION = void 0;
  * рантайме нельзя, после сборки он лежит на уровень выше dist и в бандл не
  * попадает.
  */
-exports.CLI_VERSION = '0.1.7';
+exports.CLI_VERSION = '0.1.9';
 /** Адрес платформы по умолчанию. Переопределяется XFLOW_API_URL и полем `api` в xflow.json. */
 exports.DEFAULT_API_URL = 'https://app.getxflow.com';

package/dist/zip.js

@@ -120,16 +120,16 @@ function findEocd(buffer) {
 }
 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 +143,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}`);
+            throw new ZipError(`A damaged archive entry: ${name}`);
         }
         const localNameLength = buffer.readUInt16LE(localOffset + 26);
         const localExtraLength = buffer.readUInt16LE(localOffset + 28);
@@ -161,11 +161,11 @@ 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 });
     }

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.9",
+  "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