@getxflow/cli 0.0.1 → 0.1.0

package/dist/commands/functions.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.functionsList = functionsList;
+exports.functionsDeploy = functionsDeploy;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const api_1 = require("../api");
+const config_1 = require("../config");
+const errors_1 = require("../errors");
+const session_1 = require("../session");
+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) {
+        const candidate = (0, node_path_1.join)(root, FUNCTIONS_DIR, name, entry);
+        if ((0, node_fs_1.existsSync)(candidate))
+            return candidate;
+    }
+    return null;
+}
+function discover(root) {
+    const dir = (0, node_path_1.join)(root, FUNCTIONS_DIR);
+    if (!(0, node_fs_1.existsSync)(dir))
+        return [];
+    return (0, node_fs_1.readdirSync)(dir)
+        .filter((name) => (0, node_fs_1.statSync)((0, node_path_1.join)(dir, name)).isDirectory())
+        .filter((name) => entryFor(root, name) !== null)
+        .sort();
+}
+/**
+ * Собрать функцию в один файл.
+ *
+ * esbuild берём из node_modules проекта, а не тащим зависимостью в CLI: он и так
+ * есть в каждом приложении на платформе (внутри Vite), а пакет без зависимостей
+ * ставится быстрее и не требует доверия к нашему списку.
+ *
+ * `pg` оставляем снаружи бандла сознательно: серверная обёртка подставляет схему
+ * проекта в каждое соединение, а сделать это можно только с общим драйвером.
+ */
+function bundle(root, entry) {
+    let esbuild;
+    try {
+        esbuild = require(require.resolve('esbuild', { paths: [root] }));
+    }
+    catch {
+        throw new errors_1.CliError('Не нашёл esbuild в проекте', 'Установите его: npm i -D esbuild. Обычно он уже стоит вместе с Vite');
+    }
+    const result = esbuild.buildSync({
+        entryPoints: [entry],
+        bundle: true,
+        platform: 'node',
+        target: 'node20',
+        format: 'cjs',
+        external: ['pg'],
+        write: false,
+        logLevel: 'silent',
+    });
+    const text = result.outputFiles[0]?.text;
+    if (!text)
+        throw new errors_1.CliError(`Сборка ${entry} не дала результата`);
+    return text;
+}
+async function functionsList() {
+    const { config } = (0, config_1.requireProject)();
+    const client = (0, session_1.connect)(config);
+    const data = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/functions`);
+    if (data.functions.length === 0) {
+        (0, ui_1.note)(`Функций нет. Положите код в ${FUNCTIONS_DIR}/<имя>/index.ts и выполните xflow functions deploy`);
+        return;
+    }
+    (0, ui_1.table)(data.functions.map((fn) => [
+        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 ?? '',
+    ]));
+}
+async function functionsDeploy(args) {
+    const { root, config } = (0, config_1.requireProject)();
+    const client = (0, session_1.connect)(config);
+    const wanted = args.words[1];
+    const names = wanted ? [wanted] : discover(root);
+    if (names.length === 0) {
+        throw new errors_1.CliError(`В проекте нет функций`, `Создайте ${FUNCTIONS_DIR}/<имя>/index.ts с экспортом handler и повторите`);
+    }
+    for (const name of names) {
+        const entry = entryFor(root, name);
+        if (!entry) {
+            throw new errors_1.CliError(`Не нашёл ${FUNCTIONS_DIR}/${name}/index.ts`, `Доступные функции: ${discover(root).join(', ') || 'нет ни одной'}`);
+        }
+        (0, ui_1.step)(`Собираю ${name}`);
+        const code = bundle(root, entry);
+        (0, ui_1.step)(`Выкладываю ${name}`);
+        const result = await (0, api_1.apiUpload)(client, `/api/v1/projects/${config.projectId}/functions?name=${encodeURIComponent(name)}`, Buffer.from(code, 'utf-8'), { 'Content-Type': 'application/javascript' });
+        (0, ui_1.ok)(`${(0, ui_1.bold)(result.name)} выложена`);
+        (0, ui_1.out)(result.url);
+        if (result.secrets.length > 0) {
+            (0, ui_1.note)((0, ui_1.dim)(`  Секреты организации в окружении: ${result.secrets.join(', ')}`));
+        }
+    }
+}

package/dist/commands/projects.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templates = templates;
+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 template_1 = require("../template");
+const zip_1 = require("../zip");
+const ui_1 = require("../ui");
+/** Пустой ли каталог. `.git` не считается: связывать свежий клон — обычное дело. */
+function isEmptyEnough(dir) {
+    if (!(0, node_fs_1.existsSync)(dir))
+        return true;
+    return (0, node_fs_1.readdirSync)(dir).every((name) => name === '.git');
+}
+function write(root, path, content) {
+    const full = (0, node_path_1.join)(root, path);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(full), { recursive: true });
+    (0, node_fs_1.writeFileSync)(full, content);
+}
+function escapeHtml(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/** Заголовок вкладки в шаблоне общий на всех: у проекта он должен быть свой. */
+function titleFromProject(path, content, name) {
+    if (path !== 'index.html')
+        return content;
+    const html = content.toString('utf-8').replace(/<title>[^<]*<\/title>/, `<title>${escapeHtml(name)}</title>`);
+    return Buffer.from(html, 'utf-8');
+}
+async function templates() {
+    const client = (0, session_1.connect)();
+    const { templates: list } = await (0, api_1.apiJson)(client, '/api/v1/templates');
+    if (list.length === 0) {
+        (0, ui_1.note)('Шаблонов нет');
+        return;
+    }
+    (0, ui_1.table)(list.map((t) => [t.id, t.name, t.is_default ? 'по умолчанию' : '', t.description ?? '']));
+}
+/**
+ * Создать проект: шаблон платформы, локальная папка, проект на платформе.
+ *
+ * Шаблон приезжает с платформы, а не лежит в этом пакете. Иначе появились бы две
+ * стартовые точки — веб и CLI, — и приложения из них выглядели бы по-разному, хотя
+ * платформа у них одна.
+ *
+ * Отсюда и порядок: проект заводится первым, потому что без него неоткуда взять
+ * токен для `.env`. Если запись файлов сорвётся, проект останется пустым, и CLI
+ * скажет, как его подобрать (`xflow link`), — молча оставлять сироту нельзя.
+ */
+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);
+    const client = (0, session_1.connect)();
+    if (!isEmptyEnough(target)) {
+        throw new errors_1.CliError(`Каталог ${target} не пуст`, 'Создайте проект в пустой папке: xflow init my-app. Связать существующую папку с проектом: xflow link <id>');
+    }
+    let templateId = (0, args_1.flagString)(args, 'template');
+    if (!templateId) {
+        const { templates: list } = await (0, api_1.apiJson)(client, '/api/v1/templates');
+        templateId = (list.find((t) => t.is_default) ?? list[0])?.id;
+        if (!templateId)
+            throw new errors_1.CliError('На платформе нет ни одного шаблона');
+    }
+    (0, ui_1.step)('Забираю шаблон');
+    const archive = await (0, api_1.apiBinary)(client, `/api/v1/templates/${templateId}/archive`);
+    const files = (0, zip_1.zipRead)(archive);
+    (0, ui_1.step)('Создаю проект на платформе');
+    const project = await (0, api_1.apiJson)(client, '/api/v1/projects', {
+        method: 'POST',
+        body: { name, database_id: (0, args_1.flagString)(args, 'database') ?? null },
+    });
+    try {
+        (0, node_fs_1.mkdirSync)(target, { recursive: true });
+        for (const file of files)
+            write(target, file.path, titleFromProject(file.path, file.content, name));
+        for (const file of (0, template_1.scaffoldFiles)(name))
+            write(target, file.path, file.content);
+        write(target, '.env', (0, template_1.envFile)(project.project_token ?? '', client.apiUrl));
+        const config = {
+            projectId: project.id,
+            build: { command: 'npm run build', dir: 'dist' },
+        };
+        (0, config_1.writeConfig)(target, config);
+        (0, config_1.ignoreStateInGit)(target);
+    }
+    catch (e) {
+        (0, ui_1.note)((0, ui_1.dim)(`  Проект «${project.name}» уже создан (${project.id}).`));
+        (0, ui_1.note)((0, ui_1.dim)('  Разберитесь с папкой и подберите его: xflow link ' + project.id));
+        throw e;
+    }
+    (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 card = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}`);
+    const dir = existing ? root : process.cwd();
+    (0, config_1.writeConfig)(dir, {
+        ...(existing ?? {}),
+        projectId: card.id,
+        build: existing?.build ?? { command: 'npm run build', dir: 'dist' },
+    });
+    (0, config_1.ignoreStateInGit)(dir);
+    // В исходники .env не уходит, поэтому в свежем клоне его нет вовсе, и приложение
+    // молча теряет доступ к облачным функциям. Восстанавливаем, но чужой не трогаем.
+    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));
+        (0, ui_1.note)((0, ui_1.dim)('  Создан .env с токеном проекта'));
+    }
+    (0, ui_1.ok)(`Папка связана с проектом «${card.name}»`);
+    (0, ui_1.note)((0, ui_1.dim)(`  ${(0, node_path_1.join)(dir, config_1.CONFIG_FILE)}`));
+}
+async function list() {
+    const root = (0, config_1.findProjectRoot)();
+    const client = (0, session_1.connect)(root ? (0, config_1.readConfig)(root) : undefined);
+    const { projects } = await (0, api_1.apiJson)(client, '/api/v1/projects');
+    if (projects.length === 0) {
+        (0, ui_1.note)('Проектов нет. Создать: xflow init');
+        return;
+    }
+    (0, ui_1.table)(projects.map((p) => [
+        p.id,
+        p.name,
+        p.live_url ? 'опубликован' : p.dev_url ? 'только dev' : 'без сборки',
+        (0, ui_1.formatAge)(p.updated_at),
+    ]));
+}
+async function get(args) {
+    const root = (0, config_1.findProjectRoot)();
+    const config = root ? (0, config_1.readConfig)(root) : undefined;
+    const projectId = args.words[0] ?? config?.projectId;
+    if (!projectId) {
+        throw new errors_1.CliError('Нужен идентификатор проекта', 'Либо запустите команду в папке проекта');
+    }
+    const client = (0, session_1.connect)(config);
+    const card = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}`);
+    (0, ui_1.out)(`${(0, ui_1.bold)(card.name)}  ${(0, ui_1.dim)(card.id)}`);
+    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})` : '—'}`);
+    if (card.functions.length > 0) {
+        (0, ui_1.out)('');
+        (0, ui_1.out)('Функции:');
+        (0, ui_1.table)(card.functions.map((f) => [`  ${f.name}`, f.status, (0, ui_1.formatAge)(f.last_deployed_at)]));
+    }
+    if (card.schedules.length > 0) {
+        (0, ui_1.out)('');
+        (0, ui_1.out)('Расписания:');
+        (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

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skills = skills;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const args_1 = require("../args");
+const errors_1 = require("../errors");
+const ui_1 = require("../ui");
+/**
+ * Формат SKILL.md общий для инструментов (agentskills.io), а папку каждый ищет
+ * свою: Claude Code в .claude/skills, Codex и OpenClaw в .agents/skills.
+ * Кладём один и тот же файл в обе, иначе пришлось бы спрашивать, чей агент.
+ */
+const ROOTS = [
+    ['.claude', 'skills'],
+    ['.agents', 'skills'],
+];
+/** Скилл едет в пакете рядом с dist: у CLI и у инструкций для агента одна версия. */
+function skillSource() {
+    const path = (0, node_path_1.join)(__dirname, '..', '..', 'skills', 'xflow', 'SKILL.md');
+    if (!(0, node_fs_1.existsSync)(path)) {
+        throw new errors_1.CliError('В пакете CLI нет файла скилла', 'Переустановите @getxflow/cli');
+    }
+    return (0, node_fs_1.readFileSync)(path, 'utf-8');
+}
+/**
+ * Разложить скилл платформы по папкам, где его найдёт агент.
+ *
+ * Файлы 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;
+        }
+        (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}`);
+    }
+    (0, ui_1.ok)(global ? 'Скилл xflow доступен во всех проектах' : 'Скилл xflow на месте');
+    (0, ui_1.note)((0, ui_1.dim)('  После обновления CLI повторите команду: скилл обновляется вместе с ним'));
+}

package/dist/commands/sources.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.latestRevision = latestRevision;
+exports.pushSources = pushSources;
+exports.push = push;
+exports.pull = pull;
+exports.status = status;
+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 session_1 = require("../session");
+const tree_1 = require("../tree");
+const zip_1 = require("../zip");
+const ui_1 = require("../ui");
+/** Потолок сервера. Проверяем и здесь, чтобы не гнать 25 МБ ради отказа. */
+const MAX_ARCHIVE_BYTES = 25 * 1024 * 1024;
+/** Собрать дерево исходников: что уходит на сервер и с каким хешем. */
+function prepareTree(root, config) {
+    const buildDir = config.build?.dir?.replace(/^\.\//, '').replace(/\/+$/, '');
+    const extra = [...(config.ignore ?? []), ...(buildDir ? [`${buildDir}/`] : [])];
+    const { files, skippedLinks } = (0, tree_1.collectFiles)(root, (0, tree_1.loadIgnoreRules)(root, extra));
+    if (files.length === 0) {
+        throw new errors_1.CliError('В папке нет файлов для отправки', 'Проверьте .xflowignore: возможно, исключено всё');
+    }
+    for (const link of skippedLinks) {
+        (0, ui_1.warn)(`Пропущена ссылка ${link}: символические ссылки не синхронизируются`);
+    }
+    const archive = (0, zip_1.zipCreate)(files);
+    if (archive.length > MAX_ARCHIVE_BYTES) {
+        const top = (0, tree_1.heaviest)(files)
+            .map((f) => `    ${f.path} — ${(0, ui_1.formatBytes)(f.content.length)}`)
+            .join('\n');
+        throw new errors_1.CliError(`Архив ${(0, ui_1.formatBytes)(archive.length)}, потолок ${(0, ui_1.formatBytes)(MAX_ARCHIVE_BYTES)}`, `Самые тяжёлые файлы:\n${top}\n  Исключите лишнее в .xflowignore`);
+    }
+    return { files, hash: (0, tree_1.treeHash)(files), archive };
+}
+async function latestRevision(client, projectId) {
+    const { revisions } = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}/revisions`);
+    return revisions[0] ?? null;
+}
+/**
+ * Показать, чью работу перетирает `--force`, и спросить подтверждение.
+ *
+ * Без этого текст «используйте --force» превращается в инструкцию, которую
+ * агент выполнит не задумываясь, а чужие правки исчезнут без следа (D23).
+ */
+async function confirmForce(client, projectId, server, local) {
+    const card = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}`);
+    (0, ui_1.note)('');
+    (0, ui_1.warn)(`На сервере ревизия ${server.revision} от ${(0, ui_1.formatAge)(server.created_at)}, ${server.file_count} файлов`);
+    try {
+        const info = await (0, api_1.apiJson)(client, `/api/v1/projects/${projectId}/pull`);
+        const serverPaths = new Set((0, zip_1.zipRead)(await (0, api_1.downloadUrl)(info.download_url)).map((e) => e.path));
+        const localPaths = new Set(local.map((f) => f.path));
+        const disappearing = [...serverPaths].filter((p) => !localPaths.has(p));
+        if (disappearing.length > 0) {
+            (0, ui_1.note)(`  Исчезнут файлы (${disappearing.length}):`);
+            for (const path of disappearing.slice(0, 20))
+                (0, ui_1.note)((0, ui_1.dim)(`    ${path}`));
+            if (disappearing.length > 20)
+                (0, ui_1.note)((0, ui_1.dim)(`    …и ещё ${disappearing.length - 20}`));
+        }
+        else {
+            (0, ui_1.note)((0, ui_1.dim)('  Файлы не исчезнут, но содержимое серверной ревизии будет заменено вашим'));
+        }
+    }
+    catch {
+        (0, ui_1.warn)('Не удалось прочитать серверную копию: список исчезающих файлов недоступен');
+    }
+    (0, ui_1.note)('');
+    const confirmed = await (0, ui_1.confirmWord)(`Это перетрёт чужую работу без возможности восстановить её из платформы.`, card.name);
+    if (!confirmed)
+        throw new errors_1.CliError('Отменено');
+}
+/** Отправка исходников. Используется и командой push, и первым шагом deploy. */
+async function pushSources(root, config, client, options) {
+    const tree = prepareTree(root, config);
+    const state = (0, config_1.readState)(root);
+    (0, ui_1.step)(`Отправляю ${tree.files.length} файлов (${(0, ui_1.formatBytes)(tree.archive.length)})`);
+    const server = await latestRevision(client, config.projectId);
+    // Ревизия сервера есть, а мы не знаем, от какой работали (свежий клон, чужая
+    // машина). Совпал хеш — просто синхронизируемся; не совпал — молча заливать
+    // нельзя, иначе чужая работа исчезнет без единой ошибки.
+    if (server && state.revision === undefined && !options.force) {
+        if (server.tree_hash === tree.hash) {
+            (0, config_1.writeState)(root, { revision: server.revision, treeHash: server.tree_hash });
+            (0, ui_1.ok)(`Уже синхронизировано, ревизия ${server.revision}`);
+            return { revision: server.revision, status: 'unchanged' };
+        }
+        throw new errors_1.CliError(`На сервере ревизия ${server.revision}, а эта папка не помнит, от какой версии работали`, 'Заберите серверную копию рядом и сравните: xflow pull --into ./server-copy');
+    }
+    if (options.force && server && server.tree_hash !== tree.hash) {
+        await confirmForce(client, config.projectId, server, tree.files);
+    }
+    const headers = {};
+    if (state.revision !== undefined)
+        headers['X-Base-Revision'] = String(state.revision);
+    if (options.force)
+        headers['X-Force'] = 'true';
+    const result = await (0, api_1.apiUpload)(client, `/api/v1/projects/${config.projectId}/push`, tree.archive, headers);
+    (0, config_1.writeState)(root, { revision: result.revision, treeHash: result.tree_hash });
+    if (result.status === 'unchanged') {
+        (0, ui_1.ok)(`Изменений нет, ревизия ${result.revision}`);
+    }
+    else {
+        (0, ui_1.ok)(`Ревизия ${result.revision}: ${result.file_count} файлов, ${(0, ui_1.formatBytes)(result.size_bytes)}`);
+    }
+    return { revision: result.revision, status: result.status };
+}
+async function push(args) {
+    const { root, config } = (0, config_1.requireProject)();
+    const client = (0, session_1.connect)(config);
+    await pushSources(root, config, client, { force: (0, args_1.flagBool)(args, 'force') });
+}
+/** Есть ли в каталоге что-то, кроме служебного. */
+function hasContent(dir) {
+    if (!(0, node_fs_1.existsSync)(dir))
+        return false;
+    return (0, node_fs_1.readdirSync)(dir).some((name) => name !== '.git' && name !== '.xflow');
+}
+async function pull(args) {
+    const { root, config } = (0, config_1.requireProject)();
+    const into = (0, args_1.flagString)(args, 'into');
+    const target = into ? (0, node_path_1.resolve)(into) : root;
+    const client = (0, session_1.connect)(config);
+    const revision = (0, args_1.flagNumber)(args, 'revision');
+    const query = revision !== undefined ? `?revision=${revision}` : '';
+    const info = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/pull${query}`);
+    if (hasContent(target) && !(0, args_1.flagBool)(args, 'force')) {
+        throw new errors_1.CliError(`Каталог ${target} не пуст`, 'Слить изменения платформа не умеет — это работа git. Заберите серверную копию рядом: ' +
+            'xflow pull --into ./server-copy, либо перезапишите папку целиком: xflow pull --force');
+    }
+    (0, ui_1.step)(`Скачиваю ревизию ${info.revision} (${(0, ui_1.formatBytes)(info.size_bytes)})`);
+    const entries = (0, zip_1.zipRead)(await (0, api_1.downloadUrl)(info.download_url));
+    const hash = (0, tree_1.treeHash)(entries.map((e) => ({ path: e.path, content: e.content })));
+    if (hash !== info.tree_hash) {
+        (0, ui_1.warn)('Хеш скачанного дерева не совпал с серверным: содержимое могло измениться при передаче');
+    }
+    (0, node_fs_1.mkdirSync)(target, { recursive: true });
+    for (const entry of entries) {
+        const path = (0, node_path_1.join)(target, entry.path);
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+        (0, node_fs_1.writeFileSync)(path, entry.content);
+    }
+    // Состояние пишем только для рабочей папки: копия рядом (`--into`) к отсчёту
+    // ревизий отношения не имеет, и запись туда сбила бы его у рабочей.
+    if (!into) {
+        (0, config_1.writeState)(root, { revision: info.revision, treeHash: info.tree_hash });
+    }
+    (0, ui_1.ok)(`Ревизия ${info.revision}: ${entries.length} файлов в ${target}`);
+}
+async function status() {
+    const { root, config } = (0, config_1.requireProject)();
+    const client = (0, session_1.connect)(config);
+    const tree = prepareTree(root, config);
+    const state = (0, config_1.readState)(root);
+    const [card, server] = await Promise.all([
+        (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}`),
+        latestRevision(client, config.projectId),
+    ]);
+    (0, ui_1.out)(`${(0, ui_1.bold)(card.name)}  ${(0, ui_1.dim)(card.id)}`);
+    (0, ui_1.out)('');
+    (0, ui_1.out)(`Локально:  ${tree.files.length} файлов, ${(0, ui_1.formatBytes)(tree.archive.length)} в архиве`);
+    if (!server) {
+        (0, ui_1.out)('На сервере: исходников ещё нет');
+        (0, ui_1.note)((0, ui_1.dim)('  Отправить: xflow push'));
+    }
+    else {
+        (0, ui_1.out)(`На сервере: ревизия ${server.revision}, ${server.file_count} файлов, ${(0, ui_1.formatAge)(server.created_at)}`);
+        if (server.tree_hash === tree.hash) {
+            (0, ui_1.out)('Состояние: совпадает с сервером');
+        }
+        else if (state.revision !== undefined && state.revision < server.revision) {
+            (0, ui_1.out)(`Состояние: ${(0, ui_1.bold)('расхождение')} — на сервере новее (вы работали от ${state.revision})`);
+            (0, ui_1.note)((0, ui_1.dim)('  Забрать серверную копию рядом: xflow pull --into ./server-copy'));
+        }
+        else {
+            (0, ui_1.out)(`Состояние: ${(0, ui_1.bold)('есть локальные изменения')}`);
+            (0, ui_1.note)((0, ui_1.dim)('  Отправить: xflow push'));
+        }
+    }
+    (0, ui_1.out)('');
+    (0, ui_1.out)(`dev:  ${card.dev_url ?? '—'}`);
+    (0, ui_1.out)(`live: ${card.live_url ?? '— (не публиковался)'}`);
+}

package/dist/config.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigError = exports.CONFIG_FILE = void 0;
+exports.findProjectRoot = findProjectRoot;
+exports.readConfig = readConfig;
+exports.writeConfig = writeConfig;
+exports.requireProject = requireProject;
+exports.apiUrlFor = apiUrlFor;
+exports.readState = readState;
+exports.writeState = writeState;
+exports.ignoreStateInGit = ignoreStateInGit;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const version_1 = require("./version");
+exports.CONFIG_FILE = 'xflow.json';
+const STATE_DIR = '.xflow';
+class ConfigError extends Error {
+}
+exports.ConfigError = ConfigError;
+/** Ищем корень проекта вверх по дереву: команду запускают из подкаталога чаще, чем из корня. */
+function findProjectRoot(from = process.cwd()) {
+    let dir = (0, node_path_1.resolve)(from);
+    for (;;) {
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(dir, exports.CONFIG_FILE)))
+            return dir;
+        const parent = (0, node_path_1.dirname)(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+function readConfig(root) {
+    const path = (0, node_path_1.join)(root, exports.CONFIG_FILE);
+    let parsed;
+    try {
+        parsed = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf-8'));
+    }
+    catch (e) {
+        throw new ConfigError(`Не удалось прочитать ${exports.CONFIG_FILE}: ${e instanceof Error ? e.message : e}`);
+    }
+    const config = parsed;
+    if (!config || typeof config.projectId !== 'string' || !config.projectId) {
+        throw new ConfigError(`В ${exports.CONFIG_FILE} нет projectId. Свяжите папку с проектом: xflow link <id>`);
+    }
+    return config;
+}
+function writeConfig(root, config) {
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(root, exports.CONFIG_FILE), `${JSON.stringify(config, null, 2)}\n`, 'utf-8');
+}
+/** Конфигурация проекта, из которого запущена команда. Бросает, если папка не связана. */
+function requireProject() {
+    const root = findProjectRoot();
+    if (!root) {
+        throw new ConfigError(`Папка не связана с проектом: рядом нет ${exports.CONFIG_FILE}.\n` +
+            '  Связать существующий: xflow link <id проекта>\n' +
+            '  Создать новый:        xflow init');
+    }
+    return { root, config: readConfig(root) };
+}
+function apiUrlFor(config) {
+    const raw = process.env.XFLOW_API_URL?.trim() || config?.api?.trim() || version_1.DEFAULT_API_URL;
+    return raw.replace(/\/+$/, '');
+}
+function readState(root) {
+    const path = (0, node_path_1.join)(root, STATE_DIR, 'state.json');
+    if (!(0, node_fs_1.existsSync)(path))
+        return {};
+    try {
+        return JSON.parse((0, node_fs_1.readFileSync)(path, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeState(root, state) {
+    const dir = (0, node_path_1.join)(root, STATE_DIR);
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(dir, 'state.json'), `${JSON.stringify(state, null, 2)}\n`, 'utf-8');
+}
+/**
+ * Состояние в git не нужно никому, но забыть про него легко: дописываем в
+ * .gitignore сами. Если файла нет, создаём — проект почти всегда под git.
+ */
+function ignoreStateInGit(root) {
+    const path = (0, node_path_1.join)(root, '.gitignore');
+    const line = `${STATE_DIR}/`;
+    if ((0, node_fs_1.existsSync)(path)) {
+        const content = (0, node_fs_1.readFileSync)(path, 'utf-8');
+        if (content.split(/\r?\n/).some((l) => l.trim() === line))
+            return;
+        (0, node_fs_1.appendFileSync)(path, `${content.endsWith('\n') ? '' : '\n'}${line}\n`, 'utf-8');
+        return;
+    }
+    (0, node_fs_1.writeFileSync)(path, `${line}\n`, 'utf-8');
+}