layero 0.11.3 → 0.11.5

package/README.md

@@ -357,7 +357,7 @@ Full reference: <https://docs.layero.ru/cli/json-events>
 
 `layero deploy` honours `.gitignore` and `.layeroignore`. Always excluded:
 `node_modules`, `.git`, `dist`, `build`, `.next`, `.env*`, `.DS_Store`, and
-the rule files themselves. Maximum archive size is 200 MB.
+the rule files themselves. Maximum archive size is 500 MB.
 
 ## Config
 

package/dist/agent.js

@@ -140,6 +140,8 @@ function renderHuman(event) {
                 process.stdout.write(`  ${event.hint}\n`);
             if (event.next_action)
                 process.stdout.write(`  → ${event.next_action}\n`);
+            for (const w of event.layero_warnings ?? [])
+                process.stdout.write(`! ${w}\n`);
             break;
         case "plan": {
             const src = event.sources;
@@ -158,6 +160,8 @@ function renderHuman(event) {
                 process.stdout.write(`  ${event.hint}\n`);
             if (event.next_action)
                 process.stdout.write(`  → ${event.next_action}\n`);
+            for (const w of event.layero_warnings ?? [])
+                process.stdout.write(`! ${w}\n`);
             break;
         }
         case "prebuilt":
@@ -173,7 +177,11 @@ function renderHuman(event) {
             // intentionally quiet in human mode — the next stage line takes over
             break;
         case "setup_applied":
-            process.stdout.write(event.framework ? `✓ Setup applied (${event.framework})\n` : `✓ Setup applied\n`);
+            // Фреймворк здесь — что увидел детект, а не записанная настройка:
+            // сборщик определяет его по репозиторию на каждой сборке.
+            process.stdout.write(event.framework
+                ? `✓ Setup complete (detected: ${event.framework})\n`
+                : `✓ Setup complete\n`);
             break;
         case "setup_pending":
             process.stdout.write(`· Проект ждёт настройки в панели: ${event.url}\n`);

package/dist/api.js

@@ -131,8 +131,11 @@ export class ApiClient {
      * это право: детект ошибается, и репозиторий, который эвристика считает «не
      * бэкендом», прекрасно работает одним сервисом.
      */
-    setRuntimeType(projectId, projectType, force = false) {
-        return this.request("POST", `/projects/${projectId}/runtime-type`, { project_type: projectType, force });
+    setRuntimeType(projectId, projectType, force = false, 
+    // Кто назвал тип: `user` — человек (`--type`), `platform` — детект. Тип от
+    // детекта сборщик вправе уточнить по архиву; выбор человека — нет.
+    origin = "user") {
+        return this.request("POST", `/projects/${projectId}/runtime-type`, { project_type: projectType, force, origin });
     }
     updateProject(projectId, input) {
         return this.request("PATCH", `/projects/${projectId}`, input);

package/dist/bin/layero.js

@@ -44,14 +44,14 @@ async function main() {
         .option("--debug", "print a full stack trace when a command errors");
     program
         .command("login")
-        .description("Вход через браузер (код из почты или Yandex ID): печатает одноразовый адрес и код.")
-        .option("--no-browser", "не открывать браузер — только напечатать адрес и код")
-        .addHelpText("after", "\nПримеры:\n" +
+        .description("Sign in through the browser (an emailed code or Yandex ID): prints a one-time URL and code.")
+        .option("--no-browser", "do not open the browser — only print the URL and code")
+        .addHelpText("after", "\nExamples:\n" +
         "  $ layero login\n" +
-        "  $ layero login --no-browser        # SSH, контейнер, среда агента\n" +
-        "\nДля CI и агентов вход человеком не годится — нужен долгоживущий токен:\n" +
+        "  $ layero login --no-browser        # SSH, container, agent environment\n" +
+        "\nA human sign-in does not work for CI and agents — they need a long-lived token:\n" +
         "  $ layero token create ci\n" +
-        "  $ LAYERO_TOKEN=<токен> npx layero@latest deploy")
+        "  $ LAYERO_TOKEN=<token> npx layero@latest deploy")
         .action(async (opts) => {
         await loginCmd(opts);
     });
@@ -65,14 +65,14 @@ async function main() {
         .action(whoamiCmd);
     program
         .command("username <value>")
-        .description("Задать имя аккаунта — оно же адрес личной организации. " +
-        "Без него платформе некуда положить проект. " +
-        "В интерактивном терминале `login` и `deploy` спросят его сами; " +
-        "эта команда нужна агентам и CI, где спрашивать некого.")
+        .description("Set the account username — it is also the address of your personal organization. " +
+        "Without it the platform has nowhere to put a project. " +
+        "In an interactive terminal `login` and `deploy` ask for it themselves; " +
+        "this command is for agents and CI, where there is nobody to ask.")
         .addHelpText("after", "\nExamples:\n" +
         "  $ layero username alice\n" +
         "  $ layero username my-team-bot\n\n" +
-        "Строчные латинские буквы, цифры и дефис; 2–32 символа.")
+        "Lowercase Latin letters, digits and hyphens; 2–32 characters.")
         .action(async (value) => {
         const cfg = await loadConfig();
         await usernameSetCmd(value, new ApiClient(cfg));
@@ -87,86 +87,92 @@ async function main() {
     });
     const projects = program
         .command("projects")
-        .description("Проекты аккаунта: список, создание из репозитория, удаление.");
+        .description("The account's projects: list, create from a repository, delete.");
     projects
         .command("list")
-        .description("Список ваших проектов.")
+        .description("List your projects.")
         .action(projectsListCmd);
     projects
         .command("create")
-        .description("Создать проект из репозитория подключённого провайдера — путь (a): push в ветку = превью, push в main = прод. " +
-        "GitHub — через установленное App, остальные — через `layero sources connect`.")
-        .requiredOption("--repo <provider:owner/repo>", "репозиторий: github:acme/site, gitverse:acme/site, gitlab:group/sub/project")
-        .option("--branch <name>", "основная ветка (по умолчанию — ветка репозитория по умолчанию)")
-        .option("--name <name>", "имя проекта (по умолчанию — имя репозитория)")
-        .option("--org <slug>", "организация (по умолчанию единственная)")
-        .option("--no-deploy", "не применять настройки и не запускать первую сборку — проект останется в мастере панели")
-        .addHelpText("after", "\nПримеры:\n" +
+        .description("Create a project from a repository of a connected Git provider — path (a): push to a branch = preview, push to main = production. " +
+        "GitHub is connected through the installed Layero GitHub App, other providers through `layero sources connect`.")
+        .requiredOption("--repo <provider:owner/repo>", "repository: github:acme/site, gitverse:acme/site, gitlab:group/sub/project")
+        .option("--branch <name>", "the project's main branch (default: the repository's default branch)")
+        .option("--name <name>", "project name (default: the repository name)")
+        .option("--org <slug>", "organization (default: your only one, otherwise your personal organization)")
+        .option("--no-deploy", "do not finish the setup or start the first build — the project stays in the setup wizard in the dashboard (app.layero.ru)")
+        .addHelpText("after", "\nExamples:\n" +
         "  $ layero projects create --repo github:acme/site\n" +
         "  $ layero projects create --repo gitverse:acme/site --branch develop --json\n" +
-        "\nПосле привязки команда сама применяет настройки из детекта и запускает первую сборку,\n" +
-        "как кнопка «Начать деплой» в панели. С --no-deploy проект остаётся в мастере.\n" +
-        "\nСобытия в --json: project_created, source_connected, webhook_installed | webhook_unavailable,\n" +
-        "затем setup_applied + deploy_started | setup_pending | setup_failed (проект создан, доделать в панели).\n" +
-        "Без вебхука push не собирается — заведите его вручную по адресу из webhook_unavailable.")
+        "\nOnce the repository is linked, the command finishes the setup and starts the first\n" +
+        "build itself. The detected framework, build command and output directory are not\n" +
+        "saved in the project: the builder detects them from the repository on every build\n" +
+        "(layero.json overrides them). Saved are only the monorepo app folder and the\n" +
+        "package manager from layero.json. With --no-deploy the project stays in the setup wizard.\n" +
+        "\nEvents with --json: project_created, source_connected, webhook_installed | webhook_unavailable,\n" +
+        "then setup_applied + deploy_started | setup_pending |\n" +
+        "setup_failed (the project exists; finish the setup in the dashboard).\n" +
+        "Without a webhook a push does not start a build — add the webhook by hand\n" +
+        "using the URL from webhook_unavailable.")
         .action(async (opts) => projectsCreateCmd({ ...opts, json: program.opts().json }));
     projects
         .command("delete <id_or_slug>")
-        .description("Удалить проект. НЕОБРАТИМО; требует токена со scope admin (`layero token create <имя> --scope admin`).")
-        .option("-y, --yes", "не спрашивать подтверждение (вне терминала — обязателен)")
+        .description("Delete a project. IRREVERSIBLE; requires a token with the admin scope (`layero token create <name> --scope admin`).")
+        .option("-y, --yes", "do not ask for confirmation (required outside a terminal)")
         .action(async (ref, opts) => projectsDeleteCmd(ref, { ...opts, json: program.opts().json }));
     const sources = program
         .command("sources")
-        .description("Git-провайдеры организации: какие есть, подключить по токену, посмотреть репозитории.");
+        .description("The organization's Git providers: see which are available, connect one with a token, browse repositories.");
     sources
         .command("list")
-        .description("Провайдеры платформы и подключения организации.")
-        .option("--org <slug>", "организация (по умолчанию единственная)")
+        .description("Git providers the platform supports and the organization's connections.")
+        .option("--org <slug>", "organization (default: your only one, otherwise your personal organization)")
         .action(async (opts) => sourcesListCmd({ ...opts, json: program.opts().json }));
     sources
         .command("connect <provider>")
-        .description("Подключить провайдера по персональному токену (PAT). Токен проверяется до записи и наружу не возвращается.")
-        .option("--token <pat>", "токен провайдера (остаётся в истории shell — предпочтительнее --token-stdin)")
-        .option("--token-stdin", "прочитать токен из stdin: echo \"$PAT\" | layero sources connect gitverse --token-stdin")
-        .option("--base-url <url>", "адрес собственного инстанса (GitLab, GitFlic)")
-        .option("--name <label>", "подпись подключения")
-        .option("--org <slug>", "организация (по умолчанию единственная)")
-        .addHelpText("after", "\nПримеры:\n" +
+        .description("Connect a Git provider with a personal access token (PAT). The token is verified before it is saved and is never returned.")
+        .option("--token <pat>", "provider token (stays in the shell history — prefer --token-stdin)")
+        .option("--token-stdin", "read the token from stdin: echo \"$PAT\" | layero sources connect gitverse --token-stdin")
+        .option("--base-url <url>", "URL of a self-hosted instance (GitLab, GitFlic)")
+        .option("--name <label>", "connection label")
+        .option("--org <slug>", "organization (default: your only one, otherwise your personal organization)")
+        .addHelpText("after", "\nExamples:\n" +
         "  $ echo \"$GITVERSE_TOKEN\" | layero sources connect gitverse --token-stdin\n" +
         "  $ layero sources connect gitlab --token-stdin --base-url https://git.example.com < token.txt\n" +
-        "\nПровайдеры — `layero sources list`. GitHub подключается установкой App в панели.")
+        "\nProviders: `layero sources list`. GitHub is connected by installing\n" +
+        "the Layero GitHub App in the dashboard (app.layero.ru).")
         .action(async (provider, opts) => sourcesConnectCmd(provider, { ...opts, json: program.opts().json }));
     sources
         .command("repos <connection_id>")
-        .description("Репозитории, видимые токену подключения.")
-        .option("--org <slug>", "организация (по умолчанию единственная)")
+        .description("Repositories visible to the connection's token.")
+        .option("--org <slug>", "organization (default: your only one, otherwise your personal organization)")
         .action(async (id, opts) => sourcesReposCmd(id, { ...opts, json: program.opts().json }));
     const envs = program
         .command("envs")
-        .description("Окружения проекта: ветки и их адреса.");
+        .description("The project's environments: branches and their addresses.");
     envs
         .command("list")
-        .description("Окружения проекта с адресами. У CLI-проекта одно — `cli`; у проекта с репозиторием — по ветке.")
-        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
+        .description("The project's environments with their addresses. A CLI project has one — `cli`; a project with a repository has one per branch.")
+        .option("--project <id_or_slug>", "project (default: the linked project)")
         .action(async (opts) => envsListCmd({ ...opts, json: program.opts().json }));
     const claim = program
         .command("claim")
-        .description("Проект без аккаунта (`layero deploy --claim`): статус заявки и ссылка, чтобы забрать сайт.");
+        .description("Project without an account (`layero deploy --claim`): the claim status and the link to take the site over.");
     claim
         .command("status [code]")
-        .description("Состояние заявки: жива, забрана, истекла. Без кода — из .layero/project.json.")
+        .description("Claim state: alive, claimed or expired. Without a code, the code is taken from .layero/project.json.")
         .action(async (code) => claimStatusCmd(code, { json: program.opts().json }));
     claim
         .command("accept [code]")
-        .description("Открыть страницу заявки в панели. Принять её может только человек, вошедший в панель, — CLI лишь открывает или печатает ссылку.")
-        .option("--no-browser", "не открывать браузер — только напечатать ссылку")
+        .description("Open the claim page in the dashboard (app.layero.ru). Only a person signed in to the dashboard can accept the claim — the CLI only opens or prints the link.")
+        .option("--no-browser", "do not open the browser — only print the link")
         .action(async (code, opts) => claimAcceptCmd(code, { ...opts, json: program.opts().json }));
     const orgs = program
         .command("orgs")
-        .description("Организации аккаунта: личная и команды.");
+        .description("The account's organizations: personal and team ones.");
     orgs
         .command("list")
-        .description("Все организации, в которых вы состоите.")
+        .description("All organizations you are a member of.")
         .action(orgsListCmd);
     const deploys = program
         .command("deploys")
@@ -174,7 +180,7 @@ async function main() {
     deploys
         .command("list")
         .description("List recent deploys for the project's default branch (or --branch).")
-        .option("--project <id_or_slug>", "target project (default: linked .layero/project.json)")
+        .option("--project <id_or_slug>", "project (default: the one linked in .layero/project.json)")
         .option("--branch <name>", "branch to list deploys from (default: project's default_branch)")
         .option("--limit <n>", "max entries to show (default 20)", (v) => Number(v))
         .action(async (opts) => {
@@ -186,7 +192,7 @@ async function main() {
     hooks
         .command("list")
         .description("List deploy hooks for the linked project.")
-        .option("--project <id>", "target project id (default: linked .layero/project.json)")
+        .option("--project <id>", "project id (default: the one linked in .layero/project.json)")
         .action(async (opts) => {
         await hooksListCmd(opts);
     });
@@ -194,7 +200,7 @@ async function main() {
         .command("create <name>")
         .description("Create a new deploy hook. Prints a URL — paste it into Strapi / Sanity / "
         + "Contentful / GitHub Actions / cron as a POST webhook.")
-        .option("--project <id>", "target project id (default: linked .layero/project.json)")
+        .option("--project <id>", "project id (default: the one linked in .layero/project.json)")
         .option("--branch <name>", "branch to deploy when fired (default: project default_branch, evaluated at fire time)")
         .option("--prod", "fire the hook against the production environment (default: preview)")
         .addHelpText("after", "\nExamples:\n"
@@ -207,7 +213,7 @@ async function main() {
     hooks
         .command("delete <id>")
         .description("Revoke a deploy hook. The URL stops working immediately.")
-        .option("--project <id>", "target project id (default: linked .layero/project.json)")
+        .option("--project <id>", "project id (default: the one linked in .layero/project.json)")
         .action(async (id, opts) => {
         await hooksDeleteCmd(id, opts);
     });
@@ -215,7 +221,7 @@ async function main() {
         .command("promote [deploy]")
         .description("Pin the project apex to a specific deploy (V071 production-pointer). " +
         "Without [deploy] picks the latest ready build on --branch (defaults to the 'cli' pseudo-branch).")
-        .option("--project <id_or_slug>", "target project (default: linked .layero/project.json)")
+        .option("--project <id_or_slug>", "project (default: the one linked in .layero/project.json)")
         .option("--branch <name>", "branch to pick latest ready deploy from (default: cli)")
         .option("-y, --yes", "skip the confirmation prompt (CI)")
         .addHelpText("after", "\nExamples:\n" +
@@ -232,7 +238,7 @@ async function main() {
         "moves the production pointer, so the apex comes back too when it is " +
         "served by this branch. For a SPECIFIC older deploy use " +
         "`layero promote <commit-sha>`.")
-        .option("--project <id_or_slug>", "target project (default: linked .layero/project.json)")
+        .option("--project <id_or_slug>", "project (default: the one linked in .layero/project.json)")
         .option("--branch <name>", "branch to roll back (default: project's default_branch)")
         .option("--deploy <id_or_sha>", "explicit deploy id or commit sha prefix to roll back to")
         .option("-y, --yes", "skip the confirmation prompt (CI)")
@@ -246,68 +252,68 @@ async function main() {
     });
     const env = program
         .command("env")
-        .description("Переменные окружения проекта. Значения не показываются — платформа их не отдаёт.");
-    const envProject = (c) => c.option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)");
-    envProject(env.command("list").description("Имена переменных и длина значений."))
+        .description("The project's environment variables. Values are not shown — the platform does not return them.");
+    const envProject = (c) => c.option("--project <id_or_slug>", "project (default: the linked project)");
+    envProject(env.command("list").description("Variable names and value lengths."))
         .action(async (opts) => envListCmd({ ...opts, json: program.opts().json }));
     envProject(env
         .command("set <pairs...>")
-        .description("Задать переменные: KEY=value. Остальные остаются нетронутыми.")).action(async (pairs, opts) => envSetCmd(pairs, { ...opts, json: program.opts().json }));
+        .description("Set variables as KEY=value. Other variables stay untouched.")).action(async (pairs, opts) => envSetCmd(pairs, { ...opts, json: program.opts().json }));
     envProject(env
         .command("unset <keys...>")
-        .description("Удалить переменные.")
-        .option("-y, --yes", "не спрашивать подтверждение")).action(async (keys, opts) => envUnsetCmd(keys, { ...opts, json: program.opts().json }));
+        .description("Delete variables.")
+        .option("-y, --yes", "do not ask for confirmation")).action(async (keys, opts) => envUnsetCmd(keys, { ...opts, json: program.opts().json }));
     const data = program
         .command("data")
-        .description("Data API базы: ключи, сайты, методы и доступ; адрес и ключ для фронтенда.");
+        .description("A database's Data API: keys, allowed sites, methods and access; the URL and key for the frontend.");
     data
         .command("env")
-        .description("Показать VITE_/NEXT_PUBLIC_ переменные Data API; --write кладёт их в .env.local.")
-        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
-        .option("-w, --write", "записать в файл, а не печатать")
-        .option("--file <path>", "имя файла (по умолчанию .env.local)")
-        .addHelpText("after", "\nПримеры:\n" +
-        "  $ layero data env                       # посмотреть\n" +
-        "  $ layero data env --write               # положить в .env.local\n" +
-        "\nОтдаётся только ПУБЛИЧНЫЙ ключ — тот, что и так уезжает в бандл.\n" +
-        "Секретный ключ платформа не хранит и не отдаёт: он для сервера.")
+        .description("Show the VITE_/NEXT_PUBLIC_ variables for the Data API; --write puts them in .env.local.")
+        .option("--project <id_or_slug>", "project (default: the linked project)")
+        .option("-w, --write", "write to the file instead of printing")
+        .option("--file <path>", "file name (default .env.local)")
+        .addHelpText("after", "\nExamples:\n" +
+        "  $ layero data env                       # view\n" +
+        "  $ layero data env --write               # write to .env.local\n" +
+        "\nOnly the PUBLIC key is returned — the one that ends up in the bundle anyway.\n" +
+        "The platform neither stores nor returns the secret key: it is for the server.")
         .action(async (opts) => dataEnvCmd({ ...opts, json: program.opts().json }));
     registerDataApiCommands(data, program);
     const db = program
         .command("db")
-        .description("Базы организации: завести, посмотреть, подключить к проекту, выполнить SQL.");
-    const withOrg = (c) => c.option("--org <slug>", "организация (по умолчанию единственная)");
-    withOrg(db.command("list").description("Базы организации."))
+        .description("The organization's databases: create, list, connect to a project, run SQL.");
+    const withOrg = (c) => c.option("--org <slug>", "organization (default: your only one, otherwise your personal organization)");
+    withOrg(db.command("list").description("The organization's databases."))
         .action(async (opts) => dbListCmd({ ...opts, json: program.opts().json }));
     withOrg(db
         .command("create <name>")
-        .description("Завести базу. Строка подключения печатается ОДИН раз.")
+        .description("Create a database. The connection string is printed ONCE.")
         // 🚨 ФЛАГ ОСТАВЛЕН РАДИ ЧЕСТНОГО ОТКАЗА, А НЕ РАДИ РАБОТЫ. Он обещал
         // «объём платной базы в гигабайтах» и не делал НИЧЕГО: сервер поле не
         // читает ни одним путём создания — у Shared объём задаёт тариф, у
         // выделенного диск ступени. Убрать его совсем значило бы отвечать
         // «неизвестный параметр» тому, кто им пользовался, и оставить человека
         // гадать, куда делся объём. Теперь команда говорит это словами (C9).
-        .option("--gb <number>", "БОЛЬШЕ НЕ РАБОТАЕТ: объём задаёт тариф или ступень", (v) => parseInt(v, 10))
+        .option("--gb <number>", "NO LONGER WORKS: the size is set by the plan or by the dedicated instance's tier", (v) => parseInt(v, 10))
         // 🚨 ТЕ ЖЕ ФЛАГИ РАДИ ЧЕСТНОГО ОТКАЗА. Выделенный инстанс из терминала
         // не заказать, и это осознанно: у заказа есть цена и заморозка денег, а
         // карту в терминале не привяжешь и сумму подтвердить негде. Но человек,
         // прочитавший про ступени в панели, попробует `--cpu 2` — и без этих
         // флагов получит «неизвестный параметр», то есть ответ про синтаксис
         // вместо ответа про причину.
-        .option("--cpu <number>", "выделенный инстанс: заказывается в панели", (v) => parseInt(v, 10))
-        .option("--ram <mb>", "выделенный инстанс: заказывается в панели", (v) => parseInt(v, 10))
-        .option("--dedicated", "выделенный инстанс: заказывается в панели")).action(async (name, opts) => dbCreateCmd(name, { ...opts, json: program.opts().json }));
+        .option("--cpu <number>", "dedicated instance: ordered only in the dashboard", (v) => parseInt(v, 10))
+        .option("--ram <mb>", "dedicated instance: ordered only in the dashboard", (v) => parseInt(v, 10))
+        .option("--dedicated", "dedicated instance: ordered only in the dashboard")).action(async (name, opts) => dbCreateCmd(name, { ...opts, json: program.opts().json }));
     withOrg(db
         .command("connect <database>")
-        .description("Подключить проект к базе: строка подключения приедет в его "
-        + "переменные, а домены проекта станут разрешёнными для Data API.")
-        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")).action(async (database, opts) => dbConnectCmd(database, { ...opts, json: program.opts().json }));
+        .description("Connect a project to the database: the connection string goes into the project's "
+        + "environment variables, and the project's domains become allowed origins of the Data API.")
+        .option("--project <id_or_slug>", "project (default: the linked project)")).action(async (database, opts) => dbConnectCmd(database, { ...opts, json: program.opts().json }));
     withOrg(db
         .command("disconnect <database>")
-        .description("Отвязать проект от базы: переменная уйдёт следующим деплоем, "
-        + "роль проекта удалится, домены перестанут быть разрешёнными для Data API.")
-        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")).action(async (database, opts) => dbDisconnectCmd(database, { ...opts, json: program.opts().json }));
+        .description("Disconnect a project from the database: the variable goes away with the next deploy, "
+        + "the project's role is deleted, and the project's domains stop being allowed origins of the Data API.")
+        .option("--project <id_or_slug>", "project (default: the linked project)")).action(async (database, opts) => dbDisconnectCmd(database, { ...opts, json: program.opts().json }));
     withOrg(db
         // 🚨 ЗАПРОС МОЖНО ПИСАТЬ ПРОСТО СЛЕДОМ ЗА ИМЕНЕМ БАЗЫ. Раньше `-c` был
         // ОБЯЗАТЕЛЕН, и `layero db sql моя-база "select 1"` отвечал
@@ -315,8 +321,8 @@ async function main() {
         // самой очевидной форме записи. Так эта команда и записана в приёмке
         // (C6), и так её пишет всякий, кто помнит psql.
         .command("sql <database> [sql]")
-        .description("Выполнить SQL в базе. Скрипт из нескольких операторов — одной транзакцией.")
-        .option("-c, --command <sql>", "запрос или скрипт")).action(async (database, sql, opts) => dbSqlCmd(database, {
+        .description("Run SQL in a database. A script of several statements runs as one transaction.")
+        .option("-c, --command <sql>", "query or script")).action(async (database, sql, opts) => dbSqlCmd(database, {
         ...opts,
         // Явный `-c` выигрывает: он написан намеренно, а позиционный аргумент
         // мог прилететь из истории команд.
@@ -325,71 +331,71 @@ async function main() {
     }));
     const analytics = program
         .command("analytics")
-        .description("Яндекс.Метрика: подключение и статистика сайта.");
-    const withProject = (c) => c.option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)");
-    withProject(analytics.command("status").description("Подключена ли Метрика и к какой ветке."))
+        .description("Yandex Metrica: connect it and see the site's statistics.");
+    const withProject = (c) => c.option("--project <id_or_slug>", "project (default: the linked project)");
+    withProject(analytics.command("status").description("Whether Yandex Metrica is connected, and to which branch."))
         .action(async (opts) => analyticsStatusCmd({ ...opts, json: program.opts().json }));
     withProject(analytics
         .command("connect")
-        .description("Подключить Метрику. Печатает ссылку — открыть её и разрешить доступ должен человек.")
-        .option("--branch <name>", "ветка, чей адрес получит счётчик (по умолчанию основная)")).action(async (opts) => analyticsConnectCmd({ ...opts, json: program.opts().json }));
+        .description("Connect Yandex Metrica. Prints a link — a human must open it and grant access.")
+        .option("--branch <name>", "branch whose address gets the counter (default: the main branch)")).action(async (opts) => analyticsConnectCmd({ ...opts, json: program.opts().json }));
     withProject(analytics
         .command("stats")
-        .description("Посещаемость: итоги, тренд и топ источников/устройств/страниц.")
-        .option("--period <7d|30d|90d>", "период (по умолчанию 7d)")).action(async (opts) => analyticsStatsCmd({ ...opts, json: program.opts().json }));
+        .description("Traffic: totals, trend and top sources/devices/pages.")
+        .option("--period <7d|30d|90d>", "period (default 7d)")).action(async (opts) => analyticsStatsCmd({ ...opts, json: program.opts().json }));
     withProject(analytics
         .command("disconnect")
-        .description("Отключить Метрику от проекта.")
-        .option("-y, --yes", "не спрашивать подтверждение")).action(async (opts) => analyticsDisconnectCmd({ ...opts, json: program.opts().json }));
+        .description("Disconnect Yandex Metrica from the project.")
+        .option("-y, --yes", "do not ask for confirmation")).action(async (opts) => analyticsDisconnectCmd({ ...opts, json: program.opts().json }));
     const perf = program
         .command("perf")
-        .description("Замер производительности сайта со сравнением с предыдущим деплоем.");
+        .description("Measure site performance and compare it with the previous deploy.");
     perf
         .command("check")
-        .description("Запустить замер активного деплоя. Прогон асинхронный — с --wait команда дождётся результата.")
-        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
-        .option("--wait", "дождаться результата (до 4 минут)")
+        .description("Start a measurement of the active deploy. The run is asynchronous — with --wait the command waits for the result.")
+        .option("--project <id_or_slug>", "project (default: the linked project)")
+        .option("--wait", "wait for the result (up to 4 minutes)")
         .action(async (opts) => perfCheckCmd({ ...opts, json: program.opts().json }));
     perf
         .command("show")
-        .description("Показать последний замер и сравнение с предыдущим деплоем.")
-        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
+        .description("Show the latest measurement and the comparison with the previous deploy.")
+        .option("--project <id_or_slug>", "project (default: the linked project)")
         .action(async (opts) => perfShowCmd({ ...opts, json: program.opts().json }));
     const domains = program
         .command("domains")
-        .description("Свои домены проекта: привязать, проверить DNS, сделать основным, снять.");
-    const domainOpts = (c) => c.option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)");
-    domainOpts(domains.command("list").description("Показать домены проекта."))
+        .description("The project's custom domains: attach, check DNS, make primary, remove.");
+    const domainOpts = (c) => c.option("--project <id_or_slug>", "project (default: the linked project)");
+    domainOpts(domains.command("list").description("Show the project's domains."))
         .action(async (opts) => domainsListCmd({ ...opts, json: program.opts().json }));
     domainOpts(domains
         .command("add <domain>")
-        .description("Привязать домен. Печатает DNS-записи, которые нужно вписать у регистратора; "
-        + "готовности НЕ ждёт — распространение DNS занимает от минут до часа.")).action(async (domain, opts) => domainsAddCmd(domain, { ...opts, json: program.opts().json }));
-    domainOpts(domains.command("verify <domain>").description("Проверить DNS сейчас, не дожидаясь фоновой перепроверки.")).action(async (domain, opts) => domainsVerifyCmd(domain, { ...opts, json: program.opts().json }));
-    domainOpts(domains.command("primary <domain>").description("Сделать домен основным: платформенный адрес станет 301-редиректом на него.")).action(async (domain, opts) => domainsPrimaryCmd(domain, { ...opts, json: program.opts().json }));
+        .description("Attach a domain. Prints the DNS records to add at your registrar; "
+        + "does NOT wait until the domain is ready — DNS propagation takes from minutes to an hour.")).action(async (domain, opts) => domainsAddCmd(domain, { ...opts, json: program.opts().json }));
+    domainOpts(domains.command("verify <domain>").description("Check DNS now instead of waiting for the background re-check.")).action(async (domain, opts) => domainsVerifyCmd(domain, { ...opts, json: program.opts().json }));
+    domainOpts(domains.command("primary <domain>").description("Make the domain primary: the platform address becomes a 301 redirect to it.")).action(async (domain, opts) => domainsPrimaryCmd(domain, { ...opts, json: program.opts().json }));
     domainOpts(domains
         .command("remove <domain>")
-        .description("Снять домен с проекта. Необратимо и рвёт живой трафик; требует токена со scope admin.")
-        .option("-y, --yes", "не спрашивать подтверждение")).action(async (domain, opts) => domainsRemoveCmd(domain, { ...opts, json: program.opts().json }));
+        .description("Remove the domain from the project. Irreversible and breaks live traffic; requires a token with the admin scope.")
+        .option("-y, --yes", "do not ask for confirmation")).action(async (domain, opts) => domainsRemoveCmd(domain, { ...opts, json: program.opts().json }));
     program
         .command("diagnose")
-        .description("Разобрать, почему деплой в таком состоянии: причина человеческим языком, "
-        + "окрестность ошибки в логе сборки и состояние приложения. Без --deploy берёт "
-        + "последний неуспешный деплой проекта.")
-        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный в .layero/project.json)")
-        .option("--deploy <id>", "конкретный деплой")
-        .addHelpText("after", "\nПримеры:\n  $ layero diagnose\n  $ layero diagnose --deploy 8da10ee6")
+        .description("Explain why a deploy is in its current state: the cause in plain language, "
+        + "the build log around the error, and the application's state. Without --deploy takes "
+        + "the project's most recent deploy, whatever its status.")
+        .option("--project <id_or_slug>", "project (default: the one linked in .layero/project.json)")
+        .option("--deploy <id>", "a specific deploy")
+        .addHelpText("after", "\nExamples:\n  $ layero diagnose\n  $ layero diagnose --deploy 8da10ee6")
         .action(async (opts) => {
         await diagnoseCmd({ ...opts, json: program.opts().json });
     });
     program
         .command("logs")
-        .description("Показать логи деплоя: сборки (по умолчанию) или приложения (--runtime).")
-        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
-        .option("--deploy <id>", "конкретный деплой")
-        .option("--runtime", "логи запущенного приложения вместо логов сборки")
-        .option("--tail <n>", "сколько последних строк приложения (по умолчанию 100)", (v) => Number(v))
-        .addHelpText("after", "\nПримеры:\n  $ layero logs\n  $ layero logs --runtime --tail 200")
+        .description("Show a deploy's logs: the build log (default) or the application log (--runtime).")
+        .option("--project <id_or_slug>", "project (default: the linked project)")
+        .option("--deploy <id>", "a specific deploy")
+        .option("--runtime", "the running application's logs instead of build logs")
+        .option("--tail <n>", "how many recent application log lines to show (default 100)", (v) => Number(v))
+        .addHelpText("after", "\nExamples:\n  $ layero logs\n  $ layero logs --runtime --tail 200")
         .action(async (opts) => {
         await logsCmd({ ...opts, json: program.opts().json });
     });
@@ -402,25 +408,25 @@ async function main() {
         .description("Manage the auth token directly (advanced).");
     token
         .command("create <name>")
-        .description("Выпустить долгоживущий токен для CI и агентов. " +
-        "Показывается ОДИН раз. По умолчанию read+deploy, без необратимого.")
-        .option("--scope <list>", "через запятую: read, deploy, admin")
-        .addHelpText("after", "\nПримеры:\n" +
+        .description("Issue a long-lived token for CI and agents. " +
+        "It is shown ONCE. Default scopes: read+deploy, nothing irreversible.")
+        .option("--scope <list>", "comma-separated: read, deploy, admin")
+        .addHelpText("after", "\nExamples:\n" +
         "  $ layero token create ci                       # read+deploy\n" +
-        "  $ layero token create ci --scope read          # только чтение\n" +
-        "\nВ CI:  LAYERO_TOKEN=<токен> npx layero@latest deploy")
+        "  $ layero token create ci --scope read          # read only\n" +
+        "\nIn CI:  LAYERO_TOKEN=<token> npx layero@latest deploy")
         .action(async (name, opts) => tokenCreateCmd(name, { ...opts, json: program.opts().json }));
     token
         .command("list")
-        .description("Выпущенные токены: имя, подсказка, права, последнее использование.")
+        .description("Issued tokens: name, hint, scopes, last use.")
         .action(async () => tokenListCmd({ json: program.opts().json }));
     token
         .command("revoke <id>")
-        .description("Отозвать токен. Действует немедленно.")
+        .description("Revoke a token. Takes effect immediately.")
         .action(async (id) => tokenRevokeCmd(id, { json: program.opts().json }));
     token
         .command("set <jwt>")
-        .description("Сохранить токен, полученный иначе (например, `layero token create` на другой машине).")
+        .description("Save a token obtained elsewhere (for example, with `layero token create` on another machine).")
         .action(tokenSetCmd);
     program
         .command("deploy")

package/dist/commands/data-api.js

@@ -522,57 +522,57 @@ export async function dataEnableCmd(opts) {
  */
 export function registerDataApiCommands(data, program) {
     const withDb = (c) => c
-        .option("--db <name>", "база: имя, слаг или id (по умолчанию — единственная подходящая)")
-        .option("--org <slug>", "организация (по умолчанию единственная)");
+        .option("--db <name>", "database: name, slug or id (default: the only matching database)")
+        .option("--org <slug>", "organization (default: your only one, otherwise your personal organization)");
     const json = (opts) => ({ ...opts, json: program.opts().json });
-    const keys = data.command("keys").description("Ключи Data API: список, выпуск, отзыв.");
-    withDb(keys.command("list").description("Ключи базы: префикс, срок, последний вызов. Значений нет."))
+    const keys = data.command("keys").description("Data API keys: list, issue, revoke.");
+    withDb(keys.command("list").description("The database's keys: prefix, expiry, last call. No key values."))
         .action(async (opts) => dataKeysListCmd(json(opts)));
     withDb(keys
         .command("issue")
-        .description("Выпустить ключ. Значение печатается один раз.")
-        .option("--kind <kind>", "public — для сайта, secret — для сервера", "public")
-        .option("--label <text>", "подпись, по которой ключ узнают в списке")
-        .option("--expires-in <days>", "срок: 30, 90, 365 или never", "never")).action(async (opts) => dataKeysIssueCmd(json(opts)));
+        .description("Issue a key. The value is printed once.")
+        .option("--kind <kind>", "public — for the site, secret — for the server", "public")
+        .option("--label <text>", "label to recognize the key by in the list")
+        .option("--expires-in <days>", "lifetime in days: 30, 90, 365 or never", "never")).action(async (opts) => dataKeysIssueCmd(json(opts)));
     withDb(keys
         .command("revoke <id>")
-        .description("Отозвать ключ по id или префиксу. Запросы с ним сразу получают отказ.")
-        .option("-y, --yes", "не спрашивать подтверждение")).action(async (id, opts) => dataKeysRevokeCmd(id, json(opts)));
-    const origins = data.command("origins").description("Сайты, которым можно звать базу из браузера.");
-    withDb(origins.command("list").description("Адреса проектов базы и добавленные вручную."))
+        .description("Revoke a key by id or prefix. Requests with it are refused immediately.")
+        .option("-y, --yes", "do not ask for confirmation")).action(async (id, opts) => dataKeysRevokeCmd(id, json(opts)));
+    const origins = data.command("origins").description("Sites allowed to call the database from the browser.");
+    withDb(origins.command("list").description("Addresses of the projects connected to the database, plus sites added by hand."))
         .action(async (opts) => dataOriginsListCmd(json(opts)));
     withDb(origins
         .command("add <url>")
-        .description("Пустить сайт. Данных не открывает: это решают уровни доступа.")
-        .option("--note <text>", "зачем добавлен")).action(async (url, opts) => dataOriginsAddCmd(url, json(opts)));
+        .description("Allow a site. This opens no data: access levels decide that.")
+        .option("--note <text>", "why the site was added")).action(async (url, opts) => dataOriginsAddCmd(url, json(opts)));
     withDb(origins
         .command("remove <url>")
-        .description("Убрать сайт из списка.")
-        .option("-y, --yes", "не спрашивать подтверждение")).action(async (url, opts) => dataOriginsRemoveCmd(url, json(opts)));
-    withDb(data.command("methods").description("REST и RPC базы с уровнем доступа на каждый метод."))
+        .description("Remove a site from the list.")
+        .option("-y, --yes", "do not ask for confirmation")).action(async (url, opts) => dataOriginsRemoveCmd(url, json(opts)));
+    withDb(data.command("methods").description("The database's REST and RPC methods with the access level of each."))
         .action(async (opts) => dataMethodsCmd(json(opts)));
     withDb(data
         .command("grant <object>")
-        .description("Уровень доступа к методам таблицы или функции: показывает SQL, применяет после подтверждения.")
-        .option("--get <level>", "чтение таблицы")
-        .option("--post <level>", "добавление строк")
-        .option("--patch <level>", "изменение строк")
-        .option("--delete <level>", "удаление строк")
-        .option("--call <level>", "вызов функции")
-        .option("-y, --yes", "применить без подтверждения")
-        .addHelpText("after", "\nУровни: closed — закрыто, visitor — любой посетитель, user — вошедшие, server — только сервер.\n" +
-        "Неназванные методы таблицы сохраняют текущий уровень.\n" +
-        "\nПримеры:\n" +
-        "  $ layero data grant app.products --get visitor         # каталог виден сайту\n" +
-        "  $ layero data grant app.orders --get user --post user  # заказы — вошедшим\n" +
-        "  $ layero data grant api.order_create --call visitor     # функция для сайта\n" +
-        "  $ layero data grant 'api.pick(integer)' --call server   # перегрузка — по типам\n" +
-        "\nБез --yes вне терминала команда показывает SQL, ничего не меняет и завершается ошибкой.")).action(async (object, opts) => dataGrantCmd(object, json(opts)));
+        .description("Set the access level of a table's or function's methods: shows the SQL, applies it after confirmation.")
+        .option("--get <level>", "read the table")
+        .option("--post <level>", "insert rows")
+        .option("--patch <level>", "update rows")
+        .option("--delete <level>", "delete rows")
+        .option("--call <level>", "call the function")
+        .option("-y, --yes", "apply without confirmation")
+        .addHelpText("after", "\nLevels: closed — no access, visitor — any visitor, user — signed-in users, server — server only.\n" +
+        "Table methods you do not name keep their current level.\n" +
+        "\nExamples:\n" +
+        "  $ layero data grant app.products --get visitor         # the site can read the catalog\n" +
+        "  $ layero data grant app.orders --get user --post user  # orders for signed-in users\n" +
+        "  $ layero data grant api.order_create --call visitor     # a function for the site\n" +
+        "  $ layero data grant 'api.pick(integer)' --call server   # an overload: name it by argument types\n" +
+        "\nWithout --yes outside a terminal the command shows the SQL, changes nothing and exits with an error.")).action(async (object, opts) => dataGrantCmd(object, json(opts)));
     withDb(data
         .command("enable")
-        .description("Включить Data API у базы: схема api, роли и публичный ключ. Методы закрыты.")
-        .option("--with-secret", "выпустить и секретный ключ для сервера")
-        .option("--repair", "переприменить роли и схему api у базы с включённым Data API; снимает права ролей на схему public")
-        .option("-y, --yes", "не спрашивать подтверждение для --repair")).action(async (opts) => dataEnableCmd(json(opts)));
+        .description("Enable the Data API for a database: sets up the api schema and roles, issues a public key. All methods start closed.")
+        .option("--with-secret", "also issue a secret key for the server")
+        .option("--repair", "re-apply the roles and the api schema for a database whose Data API is already enabled; revokes the roles' privileges on schema public")
+        .option("-y, --yes", "do not ask for confirmation for --repair")).action(async (opts) => dataEnableCmd(json(opts)));
     registerDataProbeCommand(data, withDb, json);
 }

package/dist/commands/data-probe.js

@@ -46,6 +46,8 @@ const ANSWER_HEADERS = [
 ];
 /** Что откат пробы не возвращает — теми же словами, что панель. */
 const NOT_UNDONE = "номера последовательностей, внешние вызовы из базы, сессионные блокировки и суточная квота вызовов";
+/** Тот же список по-английски — для `--help` (справка для агентов на английском). Правите один — правьте оба. */
+const NOT_UNDONE_HELP = "sequence numbers, outbound calls made by the database, session locks and the daily call quota";
 /** Ручка ждёт UUID (`UUID(user_id)`). */
 const UUID = /^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}$/i;
 const CONTACTS = "https://docs.layero.ru/contacts/";
@@ -515,27 +517,27 @@ export function registerDataProbeCommand(data, withDb, json) {
     const collect = (value, prev = []) => [...prev, value];
     withDb(data
         .command("probe <method> <path>")
-        .description("Проба метода настоящим запросом через шлюз: права и правила строк настоящие, запись откатывается.")
-        .option("--as <who>", "от чьего имени: visitor — посетитель (по умолчанию), user — вошедший, server — сервер")
-        .option("--user <id>", "для --as user: id пользователя приложения (UUID)")
-        .option("--query <name=value>", "параметр запроса в синтаксисе PostgREST; флаг повторяется", collect)
-        .option("--body <json>", "тело POST и PATCH: объект или массив JSON")
-        .option("--body-file <file>", "тело из файла с JSON")
-        .option("--schema <schema>", "схема таблицы: api, public или app; без флага шлюз ищет в api, затем в public, затем в app")
-        .option("--expect <status>", "ожидаемый статус: 200, 2xx или несколько через запятую; не совпал — ошибка")
-        .addHelpText("after", "\nПути: /rest/v1/<таблица>, /rest/v1/rpc/<функция> (GET или POST), /whoami (только GET).\n" +
-        "Параметры — флагами --query, не через «?» в пути.\n" +
-        "\nПримеры:\n" +
+        .description("Probe a method with a real request through the gateway: real grants and RLS policies apply, writes are rolled back.")
+        .option("--as <who>", "who makes the request: visitor — a site visitor (default), user — a signed-in user, server — the server")
+        .option("--user <id>", "for --as user: the app user's id (UUID)")
+        .option("--query <name=value>", "query parameter in PostgREST syntax; repeat the flag for more", collect)
+        .option("--body <json>", "body for POST and PATCH: a JSON object or array")
+        .option("--body-file <file>", "body from a JSON file")
+        .option("--schema <schema>", "table schema: api, public or app; without the flag the gateway looks in api, then public, then app")
+        .option("--expect <status>", "expected status: 200, 2xx or a comma-separated list; a mismatch is an error")
+        .addHelpText("after", "\nPaths: /rest/v1/<table>, /rest/v1/rpc/<function> (GET or POST), /whoami (GET only).\n" +
+        "Pass parameters as --query flags, not with a \"?\" in the path.\n" +
+        "\nExamples:\n" +
         "  $ layero data probe GET /rest/v1/products --query select=id,title --query limit=5\n" +
         "  $ layero data probe POST /rest/v1/cart --as user --user <id> --body '{\"qty\":1}'\n" +
         "  $ layero data probe POST /rest/v1/rpc/order_create --body-file order.json --as server\n" +
-        "  $ layero data probe GET /rest/v1/orders --expect 401,403   # закрыто ли посетителю\n" +
+        "  $ layero data probe GET /rest/v1/orders --expect 401,403   # is it closed to visitors?\n" +
         "  $ layero data probe GET /whoami\n" +
-        `\nЗапись откатывается. Не откатываются: ${NOT_UNDONE}.\n` +
-        "\nКод выхода — по порядку:\n" +
-        "  1. откат записи не подтверждён — ошибка data_probe_not_rolled_back;\n" +
-        "  2. статус совпал с --expect — 0;\n" +
-        "  3. шлюз ответил 5xx — ошибка data_probe_gateway_failed;\n" +
-        "  4. статус не совпал с --expect — ошибка data_probe_unexpected_status;\n" +
-        "  5. иначе 0, в том числе на отказ 4xx: 401, 403, 404 — ответ пробы, а не сбой.")).action(async (method, path, opts) => dataProbeCmd(method, path, json(opts)));
+        `\nWrites are rolled back. Not rolled back: ${NOT_UNDONE_HELP}.\n` +
+        "\nExit code, decided in this order:\n" +
+        "  1. the write rollback was not confirmed — error data_probe_not_rolled_back;\n" +
+        "  2. the status matches --expect — 0;\n" +
+        "  3. the gateway answered 5xx — error data_probe_gateway_failed;\n" +
+        "  4. the status does not match --expect — error data_probe_unexpected_status;\n" +
+        "  5. otherwise 0, including a 4xx refusal: 401, 403, 404 are the probe's answer, not a failure.")).action(async (method, path, opts) => dataProbeCmd(method, path, json(opts)));
 }

package/dist/commands/deploy.js

@@ -442,6 +442,7 @@ async function dryRun(cwd, opts, existing, cliCfg) {
         ...(hint ? { hint } : {}),
         ...(d.next_action ? { next_action: d.next_action } : {}),
         ...(d.candidates?.length ? { candidates: d.candidates } : {}),
+        ...(d.layero_warnings?.length ? { layero_warnings: d.layero_warnings } : {}),
     });
 }
 // Сколько ждём, пока живой адрес начнёт отвечать приложением. Статика
@@ -861,8 +862,11 @@ export async function deployCmd(opts) {
         }
         const dashboardUrl = projectUrl(cliCfg.apiUrl, project.id);
         const apexUrl = `https://${project.apex_hostname}`;
-        const deployRow = await api.getDeploy(started.deploy_id);
-        const probe = deployRow.environment_id
+        // Сборка уже готова: сбой этих запросов не повод объявлять её упавшей
+        // (`internal` при живом сайте, T-20260918-16). Без строки деплоя — адрес
+        // апекса и никаких чужих превью.
+        const deployRow = await api.getDeploy(started.deploy_id).catch(() => null);
+        const probe = deployRow?.environment_id
             ? await resolveReachability(api, deployRow.environment_id)
             : null;
         const liveUrl = promoted || !opts.branch
@@ -876,7 +880,7 @@ export async function deployCmd(opts) {
         // Пустой список — обычный случай и молчит. Поля может не быть вовсе, если
         // платформа старше него: `?? []` и никаких предупреждений о том, чего не
         // знаем.
-        const evicted = deployRow.preview_evicted ?? [];
+        const evicted = deployRow?.preview_evicted ?? [];
         if (evicted.length > 0) {
             emit({ event: "preview_evicted", evicted });
         }

package/dist/commands/projects.js

@@ -151,26 +151,24 @@ async function setupUrl(project) {
 }
 /** Рантайм, который панель ставит проекту ДО первой сборки; статика — как есть. */
 const RUNTIME_KINDS = new Set(["ssr_next", "streamlit", "gradio", "flask", "python_web", "node_web"]);
-/** Приложения, у которых `framework_hint` — рудимент: панель шлёт им `static`. */
-const HINT_IS_STATIC = new Set(["ssr_next", "streamlit", "gradio"]);
 const PACKAGE_MANAGERS = new Set(["npm", "yarn", "pnpm", "bun"]);
 /**
- * Тело `/setup` из подсказки детекта — так же, как его собирает мастер панели.
+ * Тело `/setup` при импорте репозитория без человека.
  *
- * Пишем только то, что детект действительно дал: пустое поле — не заглушка,
- * а «решит сборщик по репозиторию» (правило 3 `core/docs/BUILD-CONFIG.md`).
- * Менеджер пакетов закрепляем только из `layero.json`: это выбор владельца,
- * а вывод по лок-файлу сборщик и так повторит сам.
+ * 🚨 ФРЕЙМВОРК, КОМАНДА И КАТАЛОГ ИЗ ДЕТЕКТА В ПРОЕКТ НЕ УХОДЯТ. Настройки
+ * проекта сборщик исполняет дословно на КАЖДОЙ сборке (`BUILD-CONFIG.md`,
+ * правило 3), и догадка, записанная туда, становилась «выбором владельца»:
+ * репозиторий сменит сборщик — проект продолжит собирать старым. Панель
+ * перестала так делать 25.08 (T-20260824-16), а `projects create --repo`
+ * 17.09 повторил старое поведение (T-20260918-19). Пусто = «решит сборщик по
+ * клону» — тем же детектом, но на полном дереве и на каждой сборке заново.
+ *
+ * Остаётся то, что детект не угадывает, а читает как решение: менеджер пакетов
+ * из `layero.json` (выбор владельца) и папка приложения в монорепо (без неё
+ * сборщик при нескольких кандидатах откажет).
  */
 export function setupPayloadFromDetect(d) {
-    const kind = d.runtime_kind ?? null;
-    const payload = {
-        framework_hint: kind && HINT_IS_STATIC.has(kind) ? "static" : d.framework,
-    };
-    if (d.build_cmd)
-        payload.build_cmd = d.build_cmd;
-    if (d.output_dir)
-        payload.output_dir = d.output_dir;
+    const payload = {};
     if (d.layero_found && d.package_manager && PACKAGE_MANAGERS.has(d.package_manager)) {
         payload.package_manager = d.package_manager;
     }
@@ -211,12 +209,13 @@ async function finishSetup(api, project, opts) {
         });
         return;
     }
+    // Что увидел детект — для сведения: в проект эти значения не записаны.
     emit({
         event: "setup_applied",
         project: project.slug,
-        framework: payload.framework_hint ?? undefined,
-        build_cmd: payload.build_cmd ?? null,
-        output_dir: payload.output_dir ?? null,
+        framework: detected.framework ?? undefined,
+        build_cmd: detected.build_cmd || null,
+        output_dir: detected.output_dir || null,
         layero_found: detected.layero_found,
     });
     // Приложение, а не статика: тип — до первой сборки, иначе сборщик падает на
@@ -225,7 +224,7 @@ async function finishSetup(api, project, opts) {
     const kind = detected.runtime_kind ?? null;
     if (kind && RUNTIME_KINDS.has(kind) && project.project_type !== kind) {
         try {
-            await api.setRuntimeType(project.id, kind);
+            await api.setRuntimeType(project.id, kind, false, "platform");
             emit({ event: "runtime_type_applied", project_type: kind });
         }
         catch {

package/dist/detect.js

@@ -521,6 +521,33 @@ const OUTPUT_SOURCE = {
  */
 export async function detectProject(cwd, opts = {}) {
     const snap = await snapshotFromDir(cwd);
+    const warnings = layeroKeyWarnings(snap.layeroJson);
+    const d = await detectFromSnapshot(cwd, snap, opts);
+    return warnings.length ? { ...d, layero_warnings: warnings } : d;
+}
+// Значения ключа `runtime` — зеркало `layero_keys.RUNTIME_VALUES` в core.
+const RUNTIME_VALUES = new Set(["ssr_next", "node_web", "python_web", "streamlit", "gradio", "flask"]);
+/**
+ * Ключи layero.json, которые платформа НЕ применит, — с верным именем.
+ *
+ * 🚨 `"type": "vite"` пишут по аналогии с флагом `--type` (прогон evals 19.09,
+ * T-20260918-21). Сборщик ключ молча пропускал, и узнать об этом можно было
+ * только из строки в логе сборки. Синонимом не принимаем: `type` двусмыслен —
+ * `--type` принимает и фреймворк, и рантайм, — поэтому имя подсказываем по
+ * значению, как `layero_keys.suggest_key` у сборщика и панели.
+ */
+export function layeroKeyWarnings(layero) {
+    if (!layero || typeof layero !== "object" || !("type" in layero))
+        return [];
+    const value = layero.type;
+    const v = typeof value === "string" ? value.trim().toLowerCase() : "";
+    const key = RUNTIME_VALUES.has(v) ? "runtime" : "framework";
+    return [
+        `layero.json: key "type" is not applied — did you mean "${key}"? ` +
+            `Write {"${key}": ${JSON.stringify(value ?? "")}} instead.`,
+    ];
+}
+async function detectFromSnapshot(cwd, snap, opts) {
     const layero = snap.layeroJson;
     const fileFramework = str(layero?.framework);
     const outsideHint = fileFramework ? null : str(opts.frameworkHint);
@@ -682,5 +709,6 @@ export function detectedEvent(d) {
         ...(d.next_action ? { next_action: d.next_action } : {}),
         ...(d.candidates?.length ? { candidates: d.candidates } : {}),
         ...(d.ssr_warning ? { ssr_warning: d.ssr_warning } : {}),
+        ...(d.layero_warnings?.length ? { layero_warnings: d.layero_warnings } : {}),
     };
 }

package/dist/pack.js

@@ -4,7 +4,7 @@ import { tmpdir } from "node:os";
 import path from "node:path";
 import { create as tarCreate } from "tar";
 import ignore from "ignore";
-const MAX_BYTES = 200 * 1024 * 1024;
+const MAX_BYTES = 500 * 1024 * 1024;
 const DEFAULT_IGNORE = [
     "node_modules",
     ".git",
@@ -176,7 +176,7 @@ export async function packDirectory(targetDir, projectName) {
     const fst = await fs.stat(archivePath);
     if (fst.size > MAX_BYTES) {
         await fs.unlink(archivePath).catch(() => undefined);
-        throw new Error(`archive is ${(fst.size / (1024 * 1024)).toFixed(1)}MB — over the 200MB limit. ` +
+        throw new Error(`archive is ${(fst.size / (1024 * 1024)).toFixed(1)}MB — over the ${MAX_BYTES / (1024 * 1024)}MB limit. ` +
             "Trim the build output or skip large files (`.layeroignore`).");
     }
     const sha256 = await sha256OfFile(archivePath);
@@ -206,7 +206,7 @@ export async function packCwd(cwd, projectName) {
     const stat = await fs.stat(archivePath);
     if (stat.size > MAX_BYTES) {
         await fs.unlink(archivePath).catch(() => undefined);
-        throw new Error(`archive is ${(stat.size / (1024 * 1024)).toFixed(1)}MB — over the 200MB limit. ` +
+        throw new Error(`archive is ${(stat.size / (1024 * 1024)).toFixed(1)}MB — over the ${MAX_BYTES / (1024 * 1024)}MB limit. ` +
             "Add large directories to .layeroignore.");
     }
     const sha256 = await sha256OfFile(archivePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layero",
-  "version": "0.11.3",
+  "version": "0.11.5",
   "description": "Layero CLI — deploy a directory or a repo to hosting with build servers in Russia. JSON events and exit codes for AI agents and CI.",
   "license": "MIT",
   "type": "module",