@getxflow/cli 0.1.5 → 0.1.7

package/README.md

@@ -28,6 +28,7 @@ xflow publish
 | `logs` | ошибки выложенного приложения в браузере |
 | `projects list` / `projects get` / `open` | проекты организации и адреса приложения |
 | `skills` | инструкция о платформе для ИИ-агента (формат [Agent Skills](https://agentskills.io)) |
+| `mcp install` | подключить агента к платформе напрямую, без терминала |
 
 Справка по команде: `xflow help <команда>`.
 
@@ -35,5 +36,9 @@ xflow publish
 рядом описание платформы, которое Claude Code, Codex и OpenClaw подхватывают сами, когда задача
 касается XFlow. Ваши `AGENTS.md` и `CLAUDE.md` команда не трогает.
 
+`xflow mcp install` подключает агента к платформе напрямую: база, миграции, функции, расписания,
+переменные и версии становятся его инструментами, без разбора вывода команд. Код, сборка и выкладка
+остаются в CLI.
+
 Ключ хранится в `~/.xflow/credentials.json`, конфигурация проекта — в `xflow.json`.
 Для CI передайте ключ переменной `XFLOW_TOKEN`.

package/dist/api.js

@@ -18,12 +18,15 @@ class ApiError extends Error {
     code;
     status;
     hint;
-    constructor(message, code, status, hint) {
+    /** Разбор отказа, если он есть: например, нарушения, из-за которых не пошла сборка. */
+    issues;
+    constructor(message, code, status, hint, issues) {
         super(message);
         this.name = 'ApiError';
         this.code = code;
         this.status = status;
         this.hint = hint;
+        this.issues = issues;
     }
 }
 exports.ApiError = ApiError;
@@ -94,7 +97,7 @@ async function readError(response) {
     const text = await response.text().catch(() => '');
     try {
         const parsed = JSON.parse(text);
-        return new ApiError(parsed.error || `Запрос отклонён (${response.status})`, parsed.code || 'unknown', response.status, parsed.hint);
+        return new ApiError(parsed.error || `Запрос отклонён (${response.status})`, parsed.code || 'unknown', response.status, parsed.hint, parsed.issues);
     }
     catch {
         return new ApiError(`Запрос отклонён (${response.status})`, 'unknown', response.status, text.slice(0, 200) || undefined);

package/dist/args.js

@@ -20,12 +20,14 @@ const BOOLEAN_FLAGS = new Set([
     'json',
     'help',
     'version',
-    'open',
+    'global',
+    'live',
     'no-push',
     'skip-build',
     'all',
     'dry-run',
     'allow-destructive',
+    'show-token',
 ]);
 function parseArgs(argv) {
     const words = [];

package/dist/bin.js

@@ -15,6 +15,7 @@ const db_1 = require("./commands/db");
 const env_1 = require("./commands/env");
 const functions_1 = require("./commands/functions");
 const logs_1 = require("./commands/logs");
+const mcp_1 = require("./commands/mcp");
 const schedules_1 = require("./commands/schedules");
 const skills_1 = require("./commands/skills");
 const sources_1 = require("./commands/sources");
@@ -48,9 +49,6 @@ async function run(args) {
         case 'link':
             await (0, projects_1.link)(rest);
             return;
-        case 'open':
-            await (0, projects_1.open)(rest);
-            return;
         case 'projects':
             if (second === 'get') {
                 await (0, projects_1.get)({ ...args, words: args.words.slice(2) });
@@ -64,6 +62,12 @@ async function run(args) {
         case 'skills':
             (0, skills_1.skills)(rest);
             return;
+        case 'mcp':
+            if (second === undefined || second === 'install') {
+                await (0, mcp_1.mcpInstall)(rest);
+                return;
+            }
+            throw new errors_1.CliError(`Неизвестная команда: mcp ${second}`, 'Есть install');
         case 'functions':
             if (second === 'deploy') {
                 await (0, functions_1.functionsDeploy)(rest);

package/dist/commands/auth.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.login = login;
 exports.logout = logout;
 exports.whoami = whoami;
+const node_os_1 = require("node:os");
 const api_1 = require("../api");
 const config_1 = require("../config");
 const credentials_1 = require("../credentials");
 const errors_1 = require("../errors");
-const open_url_1 = require("../open-url");
 const session_1 = require("../session");
 const ui_1 = require("../ui");
 function localConfig() {
@@ -31,13 +31,20 @@ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function login() {
     const config = localConfig();
     const client = (0, session_1.anonymous)(config);
-    const start = await (0, api_1.apiJson)(client, '/api/v1/auth/device', { method: 'POST' });
+    // Имя машины уходит на сервер и становится названием ключа: иначе в списке
+    // доступов лежат одинаковые строки и непонятно, какой компьютер отзывать.
+    const start = await (0, api_1.apiJson)(client, '/api/v1/auth/device', {
+        method: 'POST',
+        body: { client_name: (0, node_os_1.hostname)() },
+    });
     (0, ui_1.note)('');
     (0, ui_1.note)(`  Код подтверждения: ${(0, ui_1.bold)(start.user_code)}`);
-    (0, ui_1.note)(`  Страница входа:    ${start.verification_uri}`);
+    (0, ui_1.note)(`  Компьютер:         ${(0, node_os_1.hostname)()}`);
+    (0, ui_1.note)(`  Ссылка для входа:  ${start.verification_uri_complete}`);
     (0, ui_1.note)('');
-    (0, ui_1.step)('Открываю браузер, код там надо сверить с показанным выше');
-    (0, open_url_1.openUrl)(start.verification_uri_complete);
+    // Браузер не открываем сами: команду часто запускает агент, и всплывшее окно
+    // забирает у человека внимание, не объяснив, что он подтверждает.
+    (0, ui_1.step)('Откройте ссылку и сверьте код на странице с показанным выше');
     const deadline = Date.now() + start.expires_in * 1000;
     let intervalMs = Math.max(start.interval, 1) * 1000;
     for (;;) {
@@ -68,9 +75,6 @@ async function login() {
             projectId: poll.project_id,
         });
         (0, ui_1.ok)(`Вход выполнен, ключ сохранён для ${client.apiUrl}`);
-        if (poll.project_id) {
-            (0, ui_1.note)((0, ui_1.dim)(`  Ключ выдан на проект ${poll.project_id}: другие проекты им недоступны`));
-        }
         return;
     }
 }
@@ -89,7 +93,6 @@ async function whoami() {
     const me = await (0, api_1.apiJson)(client, '/api/v1/me');
     (0, ui_1.out)(`Организация: ${me.organization.name ?? me.organization.id}`);
     (0, ui_1.out)(`Ключ:        xfk_${me.key.prefix}… (${me.key.scopes.join(', ')})`);
-    (0, ui_1.out)(`Проект ключа: ${me.key.project_id ?? 'вся организация'}`);
     (0, ui_1.out)(`Платформа:   ${client.apiUrl}`);
     if (process.env.XFLOW_TOKEN) {
         (0, ui_1.note)((0, ui_1.dim)('  Ключ взят из XFLOW_TOKEN, сохранённый в ~/.xflow не используется'));

package/dist/commands/deploy.js

@@ -4,45 +4,60 @@ exports.deploy = deploy;
 exports.publish = publish;
 exports.rollback = rollback;
 exports.deployments = deployments;
-const node_child_process_1 = require("node:child_process");
-const node_path_1 = require("node:path");
 const api_1 = require("../api");
 const args_1 = require("../args");
 const config_1 = require("../config");
 const errors_1 = require("../errors");
 const session_1 = require("../session");
-const tree_1 = require("../tree");
-const zip_1 = require("../zip");
 const ui_1 = require("../ui");
-const functions_1 = require("./functions");
 const sources_1 = require("./sources");
-/** Потолок артефакта на сервере. */
-const MAX_ARTIFACT_BYTES = 100 * 1024 * 1024;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 /**
- * Запустить сборку проекта.
+ * Потолок ожидания сборки в терминале. Чуть больше, чем срок, после которого
+ * платформа закрывает молчащую сборку: так разработчик увидит внятный отказ, а
+ * не «идёт дольше ожидаемого» на сборке, которую уже похоронили.
+ */
+const WAIT_LIMIT_MS = 16 * 60_000;
+/**
+ * Показать, чем проект не подошёл платформе.
  *
- * Через оболочку: команда задана разработчиком в xflow.json (`npm run build`),
- * и разбирать её самим значит спорить с тем, что он написал. Вывод идёт прямо
- * в терминал, поэтому кодировки и прогресс-бары выглядят как обычно.
+ * Печатаем весь список: правила известны заранее (скилл xflow), а узнавать их по
+ * одному через повторные запуски значит терять круг на каждое нарушение.
  */
-function runBuild(command, cwd) {
-    return new Promise((done, reject) => {
-        const child = (0, node_child_process_1.spawn)(command, { cwd, shell: true, stdio: 'inherit' });
-        child.on('error', (e) => reject(new errors_1.CliError(`Не удалось запустить сборку: ${e.message}`)));
-        child.on('close', (code) => {
-            if (code === 0) {
-                done();
-                return;
-            }
-            reject(new errors_1.CliError(`Сборка завершилась с кодом ${code}`, 'Деплой остановлен: на сервер уходит только то, что собралось'));
-        });
-    });
+function reportIssues(e) {
+    const issues = e.issues ?? [];
+    for (const issue of issues) {
+        const where = issue.file ? `${issue.file}${issue.lines?.length ? `:${issue.lines.join(', ')}` : ''}` : '';
+        (0, ui_1.out)(`  ${(0, ui_1.bold)(issue.code)} ${where}`);
+        (0, ui_1.note)((0, ui_1.dim)(`    ${issue.message}`));
+    }
+    throw new errors_1.CliError(e.message, e.hint);
+}
+/**
+ * Дождаться конца сборки, печатая фазы.
+ *
+ * Платформа отвечает на запуск сразу и не держит соединение: сборка живёт в
+ * песочнице и переживает перезапуск платформы, поэтому её состояние забирается
+ * опросом, а не потоком.
+ */
+async function waitForBuild(client, projectId, started) {
+    const deadline = Date.now() + WAIT_LIMIT_MS;
+    let shown = '';
+    while (Date.now() < deadline) {
+        await sleep(started.poll_after_ms || 3_000);
+        const build = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}/builds/${started.deploy_id}`);
+        if (build.phase !== shown) {
+            shown = build.phase;
+            (0, ui_1.step)(build.phase_title);
+        }
+        if (build.phase === 'done' || build.phase === 'failed')
+            return build;
+    }
+    throw new errors_1.CliError('Сборка идёт дольше ожидаемого', `Посмотреть состояние: xflow deployments. Версия ${started.deploy_id}`);
 }
 async function deploy(args) {
     const { root, config } = (0, config_1.requireProject)();
     const client = (0, session_1.connect)(config);
-    const buildCommand = config.build?.command ?? 'npm run build';
-    const buildDir = (0, node_path_1.resolve)(root, config.build?.dir ?? 'dist');
     let revision;
     if ((0, args_1.flagBool)(args, 'no-push')) {
         const server = await (0, sources_1.latestRevision)(client, config.projectId);
@@ -50,34 +65,34 @@ async function deploy(args) {
             throw new errors_1.CliError('На сервере нет исходников', 'Отправьте их: xflow push');
         }
         revision = server.revision;
-        (0, ui_1.warn)(`Исходники не отправлены (--no-push), деплой пойдёт от ревизии ${revision}`);
+        (0, ui_1.warn)(`Исходники не отправлены (--no-push), сборка пойдёт от ревизии ${revision}`);
     }
     else {
         revision = (await (0, sources_1.pushSources)(root, config, client, { force: (0, args_1.flagBool)(args, 'force') })).revision;
     }
-    if (!(0, args_1.flagBool)(args, 'skip-build')) {
-        // Перед сборкой, а не после: адреса функций попадают в бандл на этом шаге.
-        await (0, functions_1.refreshFunctionsEnv)(root, client, config.projectId);
-        (0, ui_1.step)(`Сборка: ${buildCommand}`);
-        await runBuild(buildCommand, root);
-    }
-    const files = (0, tree_1.collectArtifact)(buildDir);
-    if (files.length === 0) {
-        throw new errors_1.CliError(`Каталог сборки пуст: ${buildDir}`, 'Проверьте build.dir в xflow.json: там должен быть каталог, куда сборщик кладёт результат');
+    (0, ui_1.step)(`Собираю на платформе из ревизии ${revision}`);
+    let started;
+    try {
+        started = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/builds`, {
+            method: 'POST',
+            body: { revision },
+        });
     }
-    // Платформа раздаёт статику. Ловим здесь, а не после заливки: ошибка о том,
-    // что сборка серверная, полезна до того, как проект отдаст пустую страницу.
-    if (!files.some((f) => f.path === 'index.html')) {
-        throw new errors_1.CliError(`В корне ${buildDir} нет index.html`, 'Похоже на серверную сборку (SSR), а платформа раздаёт статику: соберите приложение как SPA');
+    catch (e) {
+        if (e instanceof api_1.ApiError && e.issues?.length)
+            reportIssues(e);
+        throw e;
     }
-    const archive = (0, zip_1.zipCreate)(files);
-    if (archive.length > MAX_ARTIFACT_BYTES) {
-        throw new errors_1.CliError(`Артефакт ${(0, ui_1.formatBytes)(archive.length)}, потолок ${(0, ui_1.formatBytes)(MAX_ARTIFACT_BYTES)}`, 'Уберите из сборки исходные карты (sourcemaps) и неиспользуемые ассеты');
+    const build = await waitForBuild(client, config.projectId, started);
+    if (build.phase === 'failed') {
+        if (build.log_tail) {
+            (0, ui_1.out)();
+            (0, ui_1.out)(build.log_tail);
+        }
+        throw new errors_1.CliError(build.error || 'Сборка не удалась', `Исправьте код и повторите: xflow deploy. Версия ${build.deploy_id}`);
     }
-    (0, ui_1.step)(`Выкладываю ${files.length} файлов (${(0, ui_1.formatBytes)(archive.length)})`);
-    const result = await (0, api_1.apiUpload)(client, `/api/v1/projects/${config.projectId}/deploy`, archive, { 'X-Revision': String(revision) });
-    (0, ui_1.ok)(`Версия ${result.deploy_id} собрана из ревизии ${result.revision}`);
-    (0, ui_1.out)(result.url);
+    (0, ui_1.ok)(`Версия ${build.deploy_id} собрана из ревизии ${build.revision} за ${build.elapsed_s} с`);
+    (0, ui_1.out)(build.project_url);
     (0, ui_1.note)((0, ui_1.dim)('  Показать посетителям: xflow publish'));
 }
 async function publish() {
@@ -89,9 +104,9 @@ async function publish() {
         (0, ui_1.ok)('Эта версия уже опубликована');
     }
     else {
-        (0, ui_1.ok)(`Опубликована версия ${result.deploy_id}`);
+        (0, ui_1.ok)(`Опубликована версия ${result.deploy_id}: её видят посетители`);
     }
-    (0, ui_1.out)(result.url);
+    (0, ui_1.out)(result.project_url);
 }
 async function rollback(args) {
     const { config } = (0, config_1.requireProject)();
@@ -101,8 +116,8 @@ async function rollback(args) {
     }
     const client = (0, session_1.connect)(config);
     const result = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/rollback`, { method: 'POST', body: { deploy_id: deployId } });
-    (0, ui_1.ok)(`dev-адрес переключён на версию ${result.deploy_id}`);
-    (0, ui_1.out)(result.url);
+    (0, ui_1.ok)(`dev-версия проекта переключена на ${result.deploy_id}`);
+    (0, ui_1.out)(result.project_url);
     if (result.revision !== null) {
         (0, ui_1.note)((0, ui_1.dim)(`  Код этой версии: xflow pull --revision ${result.revision} --into ./v${result.deploy_id}`));
     }

package/dist/commands/functions.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.functionsList = functionsList;
-exports.refreshFunctionsEnv = refreshFunctionsEnv;
 exports.functionsInvoke = functionsInvoke;
 exports.functionsDeploy = functionsDeploy;
 const node_fs_1 = require("node:fs");
@@ -78,7 +77,7 @@ async function functionsList() {
         fn.name,
         fn.status === 'deployed' ? 'выложена' : fn.status === 'failed' ? 'ошибка' : fn.status,
         fn.last_deployed_at ? (0, ui_1.formatAge)(fn.last_deployed_at) : '—',
-        fn.error_message ?? fn.invoke_url ?? '',
+        fn.error_message ?? '',
     ]));
 }
 /**

package/dist/commands/mcp.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpInstall = mcpInstall;
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const api_1 = require("../api");
+const args_1 = require("../args");
+const config_1 = require("../config");
+const session_1 = require("../session");
+const ui_1 = require("../ui");
+/** Клиенты, у которых есть своя команда для добавления сервера. */
+const CLIENTS = [
+    {
+        binary: 'claude',
+        label: 'Claude Code',
+        args: (url, token) => [
+            'mcp',
+            'add',
+            '--transport',
+            'http',
+            'xflow',
+            url,
+            '--header',
+            `Authorization: Bearer ${token}`,
+        ],
+        // Повторный запуск должен обновлять запись, а не спотыкаться о неё: команду
+        // выполняют и после смены ключа, и после обновления пакета.
+        reset: ['mcp', 'remove', 'xflow', '-s', 'local'],
+    },
+];
+const WINDOWS = process.platform === 'win32';
+/**
+ * Запустить чужую программу.
+ *
+ * На Windows без оболочки не найти `.cmd`-обёртки, которыми ставятся все
+ * консольные пакеты npm. А оболочка не экранирует аргументы, а склеивает их:
+ * заголовок «Authorization: Bearer …» разваливается по пробелу. Поэтому на
+ * Windows собираем строку сами и сами же расставляем кавычки.
+ */
+function quote(value) {
+    return WINDOWS ? `"${value.replace(/"/g, '""')}"` : value;
+}
+function execute(binary, args) {
+    // Вывод чужой команды перехватываем, а не пропускаем на экран: клиенты любят
+    // напечатать добавленные заголовки целиком, вместе с ключом.
+    const options = { encoding: 'utf-8' };
+    return WINDOWS
+        ? (0, node_child_process_1.spawnSync)([binary, ...args.map(quote)].join(' '), { ...options, shell: true })
+        : (0, node_child_process_1.spawnSync)(binary, args, options);
+}
+function hasBinary(binary) {
+    return execute(binary, ['--version']).status === 0;
+}
+async function mcpInstall(args) {
+    // Сервер общий для организации, поэтому команда работает и вне папки проекта.
+    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`;
+    const identity = await (0, api_1.apiJson)(client, '/api/v1/me');
+    (0, ui_1.out)(`${(0, ui_1.bold)('Сервер MCP')} ${url}`);
+    (0, ui_1.note)((0, ui_1.dim)(`  Организация: ${identity.organization.name ?? 'без названия'}`));
+    (0, ui_1.note)((0, ui_1.dim)('  Ключ на всю организацию: проект агент называет сам'));
+    let found = 0;
+    let installed = 0;
+    for (const target of CLIENTS) {
+        if (!hasBinary(target.binary))
+            continue;
+        found++;
+        (0, ui_1.step)(`Прописываю в ${target.label}`);
+        execute(target.binary, [...target.reset]);
+        const result = execute(target.binary, target.args(url, client.token));
+        if (result.status === 0) {
+            installed++;
+            (0, ui_1.ok)(`${target.label}: сервер xflow подключён`);
+        }
+        else {
+            const reason = `${result.stderr ?? ''}${result.stdout ?? ''}`.trim();
+            (0, ui_1.note)(`${target.label}: команда завершилась с ошибкой`);
+            if (reason)
+                (0, ui_1.out)((0, ui_1.dim)(`  ${reason.split(client.token).join('<ключ>').split('\n').slice(0, 5).join('\n  ')}`));
+        }
+    }
+    if (installed === 0) {
+        (0, ui_1.note)(found === 0 ? 'Не нашёл клиентов со своей командой подключения.' : 'Добавьте сервер вручную:');
+        (0, ui_1.out)(`  тип: HTTP (streamable)`);
+        (0, ui_1.out)(`  адрес: ${url}`);
+        (0, ui_1.out)(`  заголовок: Authorization: Bearer <ключ>`);
+    }
+    // Ключ печатаем только по явной просьбе: см. комментарий в шапке файла.
+    if ((0, args_1.flagBool)(args, 'show-token')) {
+        (0, ui_1.out)('');
+        (0, ui_1.out)(`${(0, ui_1.bold)('Ключ')} ${client.token}`);
+        (0, ui_1.note)((0, ui_1.dim)('  Не оставляйте его в переписке с агентом'));
+    }
+    else {
+        (0, ui_1.note)((0, ui_1.dim)(`  Ключ лежит в ${(0, node_path_1.join)((0, node_os_1.homedir)(), '.xflow', 'credentials.json')} и на экран не выводится`));
+    }
+}

package/dist/commands/projects.js

@@ -5,15 +5,14 @@ exports.init = init;
 exports.link = link;
 exports.list = list;
 exports.get = get;
-exports.open = open;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const api_1 = require("../api");
 const args_1 = require("../args");
 const config_1 = require("../config");
 const errors_1 = require("../errors");
-const open_url_1 = require("../open-url");
 const session_1 = require("../session");
+const skills_1 = require("./skills");
 const template_1 = require("../template");
 const zip_1 = require("../zip");
 const ui_1 = require("../ui");
@@ -99,24 +98,24 @@ async function init(args) {
         (0, ui_1.note)((0, ui_1.dim)('  Разберитесь с папкой и подберите его: xflow link ' + project.id));
         throw e;
     }
+    (0, skills_1.installSkillQuietly)(target);
     (0, ui_1.ok)(`Проект «${project.name}» создан: ${files.length} файлов шаблона`);
     (0, ui_1.out)('');
     (0, ui_1.out)(`  ${(0, ui_1.bold)('Дальше:')}`);
     (0, ui_1.out)(`    cd ${(0, node_path_1.basename)(target)}`);
     (0, ui_1.out)('    npm install');
     (0, ui_1.out)('    npm run dev        # разработка');
-    (0, ui_1.out)('    xflow skills       # рассказать вашему ИИ-агенту про платформу');
     (0, ui_1.out)('    xflow deploy       # отправить код, собрать и выложить');
 }
 /** Связать текущую папку с уже существующим проектом. */
 async function link(args) {
-    const projectId = args.words[0];
-    if (!projectId) {
-        throw new errors_1.CliError('Нужен идентификатор проекта', 'Список проектов: xflow projects list');
-    }
     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;
     const client = (0, session_1.connect)(existing);
+    const projectId = args.words[0];
+    if (!projectId) {
+        throw new errors_1.CliError('Нужен идентификатор проекта', 'Список: xflow projects list');
+    }
     const card = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}`);
     const dir = existing ? root : process.cwd();
     (0, config_1.writeConfig)(dir, {
@@ -131,6 +130,7 @@ async function link(args) {
         write(dir, '.env', (0, template_1.envFile)(card.project_token, client.apiUrl, card.functions));
         (0, ui_1.note)((0, ui_1.dim)('  Создан .env с токеном проекта и адресами функций'));
     }
+    (0, skills_1.installSkillQuietly)(dir);
     (0, ui_1.ok)(`Папка связана с проектом «${card.name}»`);
     (0, ui_1.note)((0, ui_1.dim)(`  ${(0, node_path_1.join)(dir, config_1.CONFIG_FILE)}`));
 }
@@ -145,7 +145,7 @@ async function list() {
     (0, ui_1.table)(projects.map((p) => [
         p.id,
         p.name,
-        p.live_url ? 'опубликован' : p.dev_url ? 'только dev' : 'без сборки',
+        p.live_deploy_id ? 'опубликован' : p.dev_deploy_id ? 'только dev' : 'без сборки',
         (0, ui_1.formatAge)(p.updated_at),
     ]));
 }
@@ -162,9 +162,11 @@ async function get(args) {
     if (card.description)
         (0, ui_1.out)(card.description);
     (0, ui_1.out)('');
-    (0, ui_1.out)(`dev:  ${card.dev_url ?? '—'}`);
-    (0, ui_1.out)(`live: ${card.live_url ?? '— (не публиковался)'}`);
-    (0, ui_1.out)(`база: ${card.database ? `${card.database.name} (${card.database.schema})` : '—'}`);
+    (0, ui_1.out)(`Собранная версия: ${card.dev_deploy_id ?? '— (сборки нет)'}`);
+    (0, ui_1.out)(`Видят посетители: ${card.live_deploy_id ?? '— (не публиковался)'}`);
+    (0, ui_1.out)(`База:             ${card.database ? `${card.database.name} (${card.database.schema})` : '—'}`);
+    (0, ui_1.out)('');
+    (0, ui_1.out)(card.project_url);
     if (card.functions.length > 0) {
         (0, ui_1.out)('');
         (0, ui_1.out)('Функции:');
@@ -176,15 +178,3 @@ async function get(args) {
         (0, ui_1.table)(card.schedules.map((s) => [`  ${s.function_name}`, s.cron_expression, s.status]));
     }
 }
-async function open(args) {
-    const { config } = (0, config_1.requireProject)();
-    const client = (0, session_1.connect)(config);
-    const card = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}`);
-    const live = (0, args_1.flagBool)(args, 'live');
-    const url = live ? card.live_url : card.dev_url;
-    if (!url) {
-        throw new errors_1.CliError(live ? 'Проект не публиковался' : 'У проекта нет сборки', live ? 'Опубликовать текущую версию: xflow publish' : 'Собрать и выложить: xflow deploy');
-    }
-    (0, ui_1.note)((0, ui_1.dim)(url));
-    (0, open_url_1.openUrl)(url);
-}

package/dist/commands/skills.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.installSkillQuietly = installSkillQuietly;
 exports.skills = skills;
 const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
@@ -9,13 +10,38 @@ const errors_1 = require("../errors");
 const ui_1 = require("../ui");
 /**
  * Формат SKILL.md общий для инструментов (agentskills.io), а папку каждый ищет
- * свою: Claude Code в .claude/skills, Codex и OpenClaw в .agents/skills.
- * Кладём один и тот же файл в обе, иначе пришлось бы спрашивать, чей агент.
+ * свою: Claude Code в .claude/skills, Codex и OpenClaw в .agents/skills. Cursor к
+ * общему формату не пришёл и читает .cursor/rules/*.mdc, поэтому туда едет тот же
+ * текст под его заголовком. Спрашивать, чей агент, мы не хотим: раскладываем всем.
  */
-const ROOTS = [
+const SKILL_DIRS = [
     ['.claude', 'skills'],
     ['.agents', 'skills'],
 ];
+/**
+ * В домашней папке набор другой. Общий .agents/skills там читает OpenClaw, а
+ * Codex смотрит его только внутри репозитория: свой личный он держит отдельно,
+ * в .codex/skills. Без этой папки `--global` тихо не работает для Codex.
+ */
+const GLOBAL_SKILL_DIRS = [...SKILL_DIRS, ['.codex', 'skills']];
+const CURSOR_RULE = ['.cursor', 'rules', 'xflow.mdc'];
+/**
+ * Указатель в AGENTS.md.
+ *
+ * Скилл подхватывается лениво: только когда описание совпало с задачей. Просьба
+ * «добавь таблицу клиентов» с ним не совпадает, и агент не узнаёт, что проект
+ * вообще живёт на платформе. AGENTS.md читается всегда и без условий, поэтому
+ * пара строк здесь решает ту часть, которую ленивый скилл закрыть не может.
+ */
+const POINTER_MARKER = '<!-- xflow-skill -->';
+const POINTER = `${POINTER_MARKER}
+## XFlow
+
+This project is hosted on the XFlow platform and ships through the \`xflow\` CLI, not
+through a git push. Read \`.agents/skills/xflow/SKILL.md\` before deploying, publishing,
+rolling back, touching the database or migrations, cloud functions, schedules,
+environment variables or production logs. Command list: \`xflow help\`.
+`;
 /** Скилл едет в пакете рядом с dist: у CLI и у инструкций для агента одна версия. */
 function skillSource() {
     const path = (0, node_path_1.join)(__dirname, '..', '..', 'skills', 'xflow', 'SKILL.md');
@@ -24,27 +50,79 @@ function skillSource() {
     }
     return (0, node_fs_1.readFileSync)(path, 'utf-8');
 }
+/** Тот же текст под заголовком Cursor: поля у него свои, а тело общее. */
+function cursorRule(skill) {
+    const description = /^description:\s*(.+)$/m.exec(skill)?.[1] ?? 'XFlow platform';
+    const body = skill.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '');
+    return `---\ndescription: ${description}\nalwaysApply: false\n---\n\n${body}`;
+}
+/** Пишет, только если содержимое отличается. Возвращает путь тронутого файла. */
+function writeIfChanged(path, content) {
+    const before = (0, node_fs_1.existsSync)(path) ? (0, node_fs_1.readFileSync)(path, 'utf-8') : null;
+    if (before === content)
+        return null;
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+    (0, node_fs_1.writeFileSync)(path, content, 'utf-8');
+    return path;
+}
 /**
- * Разложить скилл платформы по папкам, где его найдёт агент.
+ * Дописать указатель в AGENTS.md: только в конец и только один раз по маркеру.
+ * Файл принадлежит пользователю, там его правила, переписывать его мы не вправе.
+ * CLAUDE.md не трогаем вовсе: Claude Code и так читает .claude/skills.
+ */
+function appendPointer(base) {
+    const path = (0, node_path_1.join)(base, 'AGENTS.md');
+    const before = (0, node_fs_1.existsSync)(path) ? (0, node_fs_1.readFileSync)(path, 'utf-8') : null;
+    if (before?.includes(POINTER_MARKER))
+        return null;
+    (0, node_fs_1.writeFileSync)(path, before ? `${before.replace(/\s*$/, '')}\n\n${POINTER}` : POINTER, 'utf-8');
+    return path;
+}
+/** Разложить инструкцию по папкам, где её найдёт агент. Отдаёт тронутые файлы. */
+function install(base, global) {
+    const skill = skillSource();
+    const touched = [];
+    for (const dir of global ? GLOBAL_SKILL_DIRS : SKILL_DIRS) {
+        const path = writeIfChanged((0, node_path_1.join)(base, ...dir, 'xflow', 'SKILL.md'), skill);
+        if (path)
+            touched.push(path);
+    }
+    // Правило Cursor и указатель кладём только рядом с проектом: глобальных
+    // аналогов у них нет, а в домашней папке их никто не читает.
+    if (!global) {
+        const rule = writeIfChanged((0, node_path_1.join)(base, ...CURSOR_RULE), cursorRule(skill));
+        if (rule)
+            touched.push(rule);
+        const pointer = appendPointer(base);
+        if (pointer)
+            touched.push(pointer);
+    }
+    return touched;
+}
+/**
+ * Установка попутно, из `init` и `link`.
  *
- * Файлы AGENTS.md и CLAUDE.md не трогаем: они принадлежат пользователю, а наше
- * знание живёт в своей папке и переустанавливается поверх без спора за файл.
+ * Отдельной командой до этого доходили единицы, и агент оставался без знания о
+ * платформе — той самой, на которой ему предстоит работать. При этом инструкция
+ * не то, ради чего запускали команду, поэтому её сбой не роняет привязку папки.
  */
-function skills(args) {
-    const content = skillSource();
-    const global = (0, args_1.flagBool)(args, 'global');
-    const base = global ? (0, node_os_1.homedir)() : process.cwd();
-    for (const root of ROOTS) {
-        const target = (0, node_path_1.join)(base, ...root, 'xflow', 'SKILL.md');
-        const before = (0, node_fs_1.existsSync)(target) ? (0, node_fs_1.readFileSync)(target, 'utf-8') : null;
-        if (before === content) {
-            (0, ui_1.note)((0, ui_1.dim)(`  уже актуален: ${target}`));
-            continue;
+function installSkillQuietly(base) {
+    try {
+        if (install(base, false).length > 0) {
+            (0, ui_1.note)((0, ui_1.dim)('  Инструкция о платформе разложена для ИИ-агента'));
         }
-        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(target), { recursive: true });
-        (0, node_fs_1.writeFileSync)(target, content, 'utf-8');
-        (0, ui_1.out)(`${before === null ? 'создан' : 'обновлён'}: ${target}`);
     }
+    catch {
+        (0, ui_1.note)((0, ui_1.dim)('  Инструкцию для ИИ-агента положить не удалось: xflow skills'));
+    }
+}
+function skills(args) {
+    const global = (0, args_1.flagBool)(args, 'global');
+    const touched = install(global ? (0, node_os_1.homedir)() : process.cwd(), global);
+    for (const path of touched)
+        (0, ui_1.out)(path);
+    if (touched.length === 0)
+        (0, ui_1.note)((0, ui_1.dim)('  всё уже актуально'));
     (0, ui_1.ok)(global ? 'Скилл xflow доступен во всех проектах' : 'Скилл xflow на месте');
     (0, ui_1.note)((0, ui_1.dim)('  После обновления CLI повторите команду: скилл обновляется вместе с ним'));
 }

package/dist/commands/sources.js

@@ -183,6 +183,8 @@ async function status() {
         }
     }
     (0, ui_1.out)('');
-    (0, ui_1.out)(`dev:  ${card.dev_url ?? '—'}`);
-    (0, ui_1.out)(`live: ${card.live_url ?? '— (не публиковался)'}`);
+    (0, ui_1.out)(`Собранная версия: ${card.dev_deploy_id ?? '— (сборки нет)'}`);
+    (0, ui_1.out)(`Видят посетители: ${card.live_deploy_id ?? '— (не публиковался)'}`);
+    (0, ui_1.out)('');
+    (0, ui_1.out)(card.project_url);
 }

package/dist/help.js

@@ -18,8 +18,9 @@ ${(0, ui_1.bold)('Начало работы')}
   xflow login                     вход через браузер
   xflow init [папка]              новый проект из шаблона платформы
   xflow templates                 какие шаблоны доступны
-  xflow link <id>                 связать текущую папку с существующим проектом
-  xflow skills [--global]         положить инструкцию о платформе для ИИ-агента
+  xflow link <id>                 связать текущую папку с проектом (id: xflow projects list)
+  xflow skills [--global]         обновить инструкцию о платформе для ИИ-агента
+  xflow mcp install               доступ к платформе для агента без терминала
 
 ${(0, ui_1.bold)('Код')}
   xflow status                    что на сервере и чем отличается локальная копия
@@ -28,10 +29,9 @@ ${(0, ui_1.bold)('Код')}
                                   забрать исходники (по умолчанию последнюю ревизию)
 
 ${(0, ui_1.bold)('Выкладка')}
-  xflow deploy [--no-push] [--skip-build]
-                                  отправить код, собрать локально и выложить на dev
+  xflow deploy [--no-push]        отправить код, собрать на платформе и выложить на dev
   xflow publish                   показать dev-версию посетителям
-  xflow rollback <номер версии>    вернуть dev-адрес на прошлую версию
+  xflow rollback <номер версии>    вернуть проект на прошлую версию
   xflow deployments               история версий
 
 ${(0, ui_1.bold)('Функции')}
@@ -57,7 +57,6 @@ ${(0, ui_1.bold)('Справочное')}
   xflow logs [--limit N]          ошибки выложенного приложения в браузере
   xflow projects list             проекты организации
   xflow projects get [id]         карточка проекта
-  xflow open [--live]             открыть приложение в браузере
   xflow whoami                    чей ключ и что он может
   xflow logout                    забыть ключ
 
@@ -162,22 +161,46 @@ ${(0, ui_1.bold)('xflow functions deploy')} затронутых функций.
 Печатает статус, время ответа и тело. Ненулевой код возврата на статусе 4xx и
 5xx: в CI такой вызов должен ронять шаг. Причину падения показывает
 ${(0, ui_1.bold)('xflow functions logs <имя>')}.`,
+    mcp: `${(0, ui_1.bold)('xflow mcp install')} — подключить агента к платформе напрямую
+
+Прописывает сервер MCP в конфигурацию клиента, у которого есть своя команда
+подключения: сегодня это Claude Code, остальным команда покажет, что вписать
+руками. После этого агент управляет платформой без терминала: смотрит базу,
+применяет миграции, выкладывает и вызывает функции, ставит расписания, читает
+логи. Команды остаются: код, сборку и выкладку по-прежнему делает CLI, гнать
+исходники через MCP значит забивать контекст агента и тратить ваши деньги.
+
+Ключ доступа команда берёт из вашего входа и на экран не выводит: обычно её
+запускает сам агент, а всё напечатанное попадает в его контекст и в историю
+переписки.
+
+  --show-token    всё же показать ключ (не под агентом)
+
+Ключ один на человека в организации, и область у него не сужается: агент видит
+все проекты организации и называет нужный сам. Проект он берёт из аргумента
+${(0, ui_1.bold)('project_id')}, а не из вашей папки — папки он не видит.`,
     skills: `${(0, ui_1.bold)('xflow skills')} — инструкция о платформе для ИИ-агента
 
-Кладёт файл в формате Agent Skills (agentskills.io): что такое XFlow, как выкладывать
-и публиковать, откуда брать компоненты дизайн-системы, где смотреть ошибки прода.
-Агент подхватывает его сам, когда задача про платформу, и не тратит контекст в
-остальное время.
+Про XFlow агенту знать неоткуда: в его обучении платформы нет. Инструкция объясняет,
+как выкладывать и публиковать, откуда брать компоненты дизайн-системы, где смотреть
+ошибки прода. ${(0, ui_1.bold)('init')} и ${(0, ui_1.bold)('link')} раскладывают её сами — эта команда нужна, чтобы
+обновить её после обновления CLI: они едут одной версией.
 
-Файл общий для инструментов, а папки у них разные, поэтому кладём в обе:
-${(0, ui_1.bold)('.claude/skills/xflow/')} читает Claude Code, ${(0, ui_1.bold)('.agents/skills/xflow/')} — Codex и OpenClaw.
+Формат общий (agentskills.io), а папки у инструментов разные, поэтому кладём во все:
 
-  --global    положить в домашнюю папку, тогда скилл виден во всех проектах
+  .claude/skills/xflow/SKILL.md    Claude Code
+  .agents/skills/xflow/SKILL.md    Codex, OpenClaw
+  .cursor/rules/xflow.mdc          Cursor: общий формат он не читает
 
-${(0, ui_1.bold)('AGENTS.md')} и ${(0, ui_1.bold)('CLAUDE.md')} команда не трогает: это ваши файлы, в них ваши правила.
-Наше знание живёт в своей папке и переустанавливается поверх без спора за файл.
+  --global    то же в домашней папке, тогда скилл виден во всех проектах.
+              Там добавляется ~/.codex/skills: общий каталог Codex смотрит
+              только внутри репозитория. Правило Cursor и AGENTS.md остаются
+              проектными, глобальных аналогов у них нет
 
-Скилл едет вместе с CLI, поэтому после обновления пакета команду стоит повторить.`,
+Плюс несколько строк-указателей в ${(0, ui_1.bold)('AGENTS.md')}. Скилл подхватывается лениво, только
+когда описание совпало с задачей, и на «добавь таблицу клиентов» он не сработает.
+AGENTS.md агент читает всегда, поэтому указатель дописывается туда — в конец файла и
+один раз. ${(0, ui_1.bold)('CLAUDE.md')} не трогаем: Claude Code и так читает .claude/skills.`,
     push: `${(0, ui_1.bold)('xflow push')} — отправить исходники
 
 Уходит вся рабочая копия целиком, одной ревизией. Не отправляются: node_modules,
@@ -202,18 +225,20 @@ ${(0, ui_1.bold)('AGENTS.md')} и ${(0, ui_1.bold)('CLAUDE.md')} команда
   --force            перезаписать папку целиком`,
     deploy: `${(0, ui_1.bold)('xflow deploy')} — собрать и выложить
 
-Три шага: отправка исходников, локальная сборка, заливка результата. Команда
-сборки и каталог результата берутся из xflow.json (по умолчанию npm run build
-и dist).
+Два шага: отправка исходников и сборка на платформе. Команда сборки и каталог
+результата берутся из xflow.json (по умолчанию npm run build и dist).
 
-  --no-push       не отправлять исходники, выложить из последней серверной ревизии
-  --skip-build    не собирать, взять готовый каталог сборки
+  --no-push       не отправлять исходники, собрать из последней серверной ревизии
   --force         разрешить перезапись серверной ревизии при отправке
 
-Сборка идёт на вашей машине, поэтому её результат зависит от вашей версии Node.
-Платформа раздаёт статику: сборка без index.html в корне отклоняется.
+Собирает платформа, в чистой песочнице с одинаковой для всех версией Node,
+поэтому «у меня работало» больше не зависит от вашей машины. Перед сборкой
+проект проверяется на соответствие шаблону: несоответствия печатаются списком,
+и сборка не запускается вовсе.
 
-Выложенное видно только по dev-адресу. Посетителям — после ${(0, ui_1.bold)('xflow publish')}.`,
+Собранную версию видно на странице проекта, ссылку CLI печатает. Посетителям — после
+${(0, ui_1.bold)('xflow publish')}. Адрес самой сборки не печатается: в нём зашит номер версии, и
+после следующей публикации такая ссылка молча отдаёт старую копию.`,
     init: `${(0, ui_1.bold)('xflow init')} [папка] — новый проект
 
 Разворачивает шаблон платформы: React на Vite, Tailwind, набор компонентов
@@ -233,7 +258,7 @@ ${(0, ui_1.bold)('AGENTS.md')} и ${(0, ui_1.bold)('CLAUDE.md')} команда
 как подобрать его командой link.`,
     rollback: `${(0, ui_1.bold)('xflow rollback')} <номер версии> — вернуть прошлую сборку
 
-Переключает dev-адрес на выбранную версию. Возвращается только сборка: исходники
+Переключает проект на выбранную сборку. Возвращается только она: исходники
 остаются на своей ревизии, и вернуть их — отдельное решение
 (${(0, ui_1.bold)('xflow pull --revision N --into ./старая-версия')}).
 

package/dist/template.js

@@ -20,7 +20,7 @@ const README = `# %NAME%
 \`\`\`bash
 npm install       # зависимости
 npm run dev       # разработка на localhost:3000
-xflow deploy      # отправить код, собрать и выложить на dev-адрес
+xflow deploy      # отправить код и собрать на платформе
 xflow publish     # показать dev-версию посетителям
 \`\`\`
 

package/dist/tree.js

@@ -4,7 +4,6 @@ exports.loadIgnoreRules = loadIgnoreRules;
 exports.collectFiles = collectFiles;
 exports.treeHash = treeHash;
 exports.heaviest = heaviest;
-exports.collectArtifact = collectArtifact;
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
@@ -134,28 +133,3 @@ function treeHash(files) {
 function heaviest(files, count = 5) {
     return [...files].sort((a, b) => b.content.length - a.content.length).slice(0, count);
 }
-/** Собрать дерево из каталога сборки: пути внутри артефакта считаются от него. */
-function collectArtifact(dir) {
-    const files = [];
-    const walk = (current) => {
-        for (const entry of (0, node_fs_1.readdirSync)(current, { withFileTypes: true })) {
-            const full = (0, node_path_1.join)(current, entry.name);
-            if (entry.isSymbolicLink())
-                continue;
-            if (entry.isDirectory()) {
-                walk(full);
-                continue;
-            }
-            if (!entry.isFile())
-                continue;
-            files.push({
-                path: (0, node_path_1.relative)(dir, full).split(node_path_1.sep).join('/'),
-                content: (0, node_fs_1.readFileSync)(full),
-            });
-        }
-    };
-    if (!(0, node_fs_1.existsSync)(dir) || !(0, node_fs_1.statSync)(dir).isDirectory())
-        return files;
-    walk(dir);
-    return files;
-}

package/dist/types.js

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

package/dist/version.js

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

package/package.json

@@ -1,22 +1,22 @@
-{
-  "name": "@getxflow/cli",
-  "version": "0.1.5",
-  "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.7",
+  "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"
+  }
+}

package/skills/xflow/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: xflow
-description: Build, deploy and publish apps on the XFlow platform with the xflow CLI. Use when the project root has xflow.json or VITE_XFLOW_* variables, when asked to deploy, publish, roll back a version, sync sources with the platform, look into errors from a deployed app, or build UI on the platform design system.
+description: Build, deploy and publish apps on the XFlow platform with the xflow CLI. Use whenever the project root has xflow.json or VITE_XFLOW_* variables, and for any task that touches deployment, publishing, rollback, source sync, the project database or SQL migrations, cloud functions, schedules, environment variables and secrets, production errors and logs, or UI built on the platform design system.
 ---
 
 # XFlow
@@ -22,19 +22,68 @@ contains the fix. Help output is in Russian.
 2. `npm run typecheck` for a two-second type check (older projects may not have the
    script, then `npx tsc --noEmit`).
 3. `npm run build` if the change is substantial, before deploying.
-4. `xflow deploy` sends the sources, builds locally, uploads the version. It prints
-   a URL: that is the dev address, visible to the team, not to visitors.
-5. Open and check it: the URL from the output, or `xflow open`.
+4. `xflow deploy` sends the sources and builds them on the platform, printing each
+   phase and the six-digit number of the version it built.
+5. Give the user the project link the CLI printed and let them look. Do not open a
+   browser for them.
 6. `xflow publish` makes that same version visible to visitors.
 
 The split is deliberate: shipping a build and showing it are two separate decisions.
 Until `publish` runs, visitors keep seeing the previous version.
 
 Rolling back: `xflow deployments` lists the version history, `xflow rollback <id>`
-points the dev address back at an earlier build. Sources stay on their own revision.
-
-The build runs on the developer machine. The platform has no builder, it serves
-static files: a build without `index.html` in the root is rejected.
+points the project back at an earlier build. Sources stay on their own revision.
+
+**The only link you give a person is the project page**, `https://app.getxflow.com/projects/<id>`,
+which the CLI prints for you. Refer to builds by their number ("version 481203 is built,
+092399 is what visitors see"), never by address. The platform does not hand out build
+addresses and neither should you: a build address has the version number baked into it,
+and after the next publish it does not break, it keeps answering with the old copy. Anyone
+holding that link then stares at a frozen app and concludes the changes never shipped. The
+project page always shows the current state, and every version is reachable from it.
+
+The platform builds the project itself, in a clean sandbox with one Node version for
+everyone, and serves the result as static files. Nothing is built on your machine for
+deployment, so a local `npm run build` is only a fast way to see errors early.
+
+## Build gate
+
+Before the sandbox starts, the platform checks the sources against the template. Every
+rule below blocks the build, and the whole list of violations comes back at once, with
+files and line numbers. Nothing is charged for a rejected attempt: the sandbox never
+starts. Write code that already satisfies these rules instead of learning them from
+rejections.
+
+Build setup:
+
+- `package.json` with the build script named in `xflow.json` (`npm run build` by default).
+- Vite: a `vite.config.*` and `vite` in dependencies.
+- No server frameworks: `next`, `nuxt`, `remix`, `@sveltejs/kit`, `astro`.
+- `index.html` in the root, `src/main.tsx` as the entry point.
+- Application code under `src/`. Root `app/`, `pages/`, `next/` are rejected.
+
+Platform contract, checked across all of `src/`:
+
+- Call cloud functions through `xflow.functions.invoke`, never through a hardcoded
+  `*.yandexcloud.net` URL: the address changes and the app breaks silently.
+- No API keys or tokens in the source: they end up in the bundle. Put the call in a
+  cloud function and the key in project secrets.
+- No server modules (`fs`, `express`, `http`, `child_process`): there is no server runtime.
+
+Interface rules, checked outside `src/components/ui` and `src/components/blocks`:
+
+- No `alert()`, `confirm()`, `prompt()`. Use the Dialog and Toast components.
+- No `console.log`. Deployed apps have a public console, and forgotten debugging prints
+  user data into it. `console.error` and `console.warn` are fine, they reach the project
+  logs.
+- No inline styles with literal values (`style={{ color: '#fff' }}`). Computed styles
+  (a drag transform, a progress width) are fine, Tailwind cannot express them.
+- No hex colors or Tailwind palette classes (`text-gray-500`): use the theme tokens.
+  Charts are exempt, they need real colors.
+- No importing a `@/components/ui/*` component that does not exist in the project.
+- A library that needs a provider (`@tanstack/react-query`, `react-redux`, `sonner`,
+  `react-hot-toast`, `react-dnd`) must have it mounted in `App.tsx`. Missing providers
+  build fine and give visitors a white screen.
 
 ## Cloud functions
 
@@ -78,6 +127,18 @@ in filename order by `xflow db migrate`. `xflow db status` shows what is applied
 waits. History lives in the database itself, so an already applied file is never re-run and
 editing it changes nothing: write a new migration instead.
 
+The browser never reaches the database directly. The app reads and writes through a cloud
+function, and inside the handler the connection string is already there:
+
+```js
+const { Client } = require('pg')
+const db = new Client({ connectionString: process.env.DATABASE_URL })
+```
+
+The platform passes `DATABASE_URL` only to functions that mention it, and sets the project
+schema on every connection, so plain table names (`select * from tasks`) hit your project.
+You never write that variable yourself: `xflow env set DATABASE_URL=...` is refused.
+
 The platform keeps no database history and no backups. Anything that destroys data
 (`DROP TABLE`, `DROP COLUMN`, `TRUNCATE`, `DELETE FROM` without a condition) is refused
 unless you pass `--allow-destructive`, and with that flag the affected tables are dumped
@@ -97,6 +158,21 @@ Fetch their work next to yours (`xflow pull --into ./server-copy`), merge it loc
 then push again. `--force` destroys their work: a last resort, not a way around the
 error.
 
+## Direct access without the terminal
+
+The platform also exposes an MCP server, connected with `xflow mcp install`. When its tools
+are available, prefer them for control-plane work: project state, database schema and
+read-only queries, migrations, function logs and invocations, schedules, environment
+variables, versions, publish and rollback. They answer with aggregates and say explicitly
+when a result is truncated, which parsing terminal output does not.
+
+Code never travels through those tools. Sending sources and deploying functions stay in
+the CLI (`xflow push`, `xflow functions deploy`): pulling a repository through tool calls
+burns the user's tokens for nothing. Building is available through the tools, because it
+runs from the revision already stored on the server: `deployments action=build` starts it
+and answers immediately, `action=status` reports the phase. A build takes minutes, so
+never expect the starting call to return a finished version.
+
 ## Do not
 
 - Edit `xflow.json` by hand: the CLI writes it.

package/dist/open-url.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.openUrl = openUrl;
-const node_child_process_1 = require("node:child_process");
-/**
- * Открыть адрес в браузере пользователя.
- *
- * Best-effort: на сервере без графики открывать нечего, и это не ошибка —
- * вызывающий в любом случае печатает ссылку рядом.
- */
-function openUrl(url) {
-    try {
-        const command = process.platform === 'win32' ? 'cmd' : process.platform === 'darwin' ? 'open' : 'xdg-open';
-        const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
-        const child = (0, node_child_process_1.spawn)(command, args, { stdio: 'ignore', detached: true });
-        child.on('error', () => {
-            // Браузера нет — молча, ссылка уже показана.
-        });
-        child.unref();
-    }
-    catch {
-        // То же самое: открыть не удалось, но команда не про это.
-    }
-}