@getxflow/cli 0.1.4 → 0.1.7

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)('Функции')}
@@ -44,6 +44,9 @@ ${(0, ui_1.bold)('Функции')}
   xflow schedules set <имя> "0 3 ? * * *"
                                   запускать функцию по расписанию (UTC)
   xflow schedules rm <имя>        снять расписание
+  xflow env [check]               переменные функций: что записано, чего не хватает
+  xflow env set ИМЯ=значение      записать переменную
+  xflow env rm ИМЯ                удалить переменную
 
 ${(0, ui_1.bold)('База данных')}
   xflow db status                 какие миграции применены, а какие ждут
@@ -54,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                    забыть ключ
 
@@ -106,6 +108,27 @@ ${(0, ui_1.bold)('xflow functions invoke')}.
 
 Ошибки браузера собирает ${(0, ui_1.bold)('src/utils/error-logger.ts')} шаблона и только с
 выложенных адресов: локальный ${(0, ui_1.bold)('npm run dev')} сюда не пишет.`,
+    env: `${(0, ui_1.bold)('xflow env')} — переменные окружения функций
+
+Ключи, пароли и адреса чужих сервисов хранит платформа, а не репозиторий.
+Значение уходит наверх и обратно не возвращается: увидеть его можно только внутри
+функции. Так что своё же значение придётся хранить там, где вы его взяли.
+
+  xflow env                        что записано (имена, не значения)
+  xflow env check                  чего не хватает функциям этого проекта
+  xflow env set SMTP_PASSWORD=…    записать
+  xflow env rm SMTP_PASSWORD       удалить
+
+  --scope project                  видно только этому проекту, а не всей организации
+
+${(0, ui_1.bold)('check')} читает исходники в ${(0, ui_1.bold)('functions/')} и ищет обращения ${(0, ui_1.bold)('process.env.ИМЯ')}. Это же
+правило действует на выкатке: функция получает только те переменные, которые сама
+упоминает по имени. Имя, собранное выражением (${(0, ui_1.bold)("process.env['KEY_' + n]")}), в окружение
+не попадёт — читайте переменные буквально.
+
+Значение доезжает до функции на выкатке, а не в момент записи: после ${(0, ui_1.bold)('env set')} нужно
+${(0, ui_1.bold)('xflow functions deploy')} затронутых функций. То же и после удаления: в уже выложенной
+функции старое значение останется до следующей выкатки.`,
     schedules: `${(0, ui_1.bold)('xflow schedules')} — запуск функций по времени
 
 Расписание это таймер-триггер Yandex: он зовёт функцию сам, без участия
@@ -138,22 +161,46 @@ ${(0, ui_1.bold)('xflow functions invoke')}.
 Печатает статус, время ответа и тело. Ненулевой код возврата на статусе 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,
@@ -178,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, набор компонентов
@@ -209,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.4';
+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.4",
-  "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"
+  }
+}