layero 0.9.5 → 0.10.1

package/dist/agent.js

@@ -116,10 +116,15 @@ function renderHuman(event) {
             process.stdout.write(`✓ Имя аккаунта: ${event.username} (организация ${event.organization})\n`);
             break;
         case "project_created":
-            process.stdout.write(`✓ Created project ${event.slug} (org: ${event.organization})\n`);
+            process.stdout.write(`✓ Created project ${event.slug} (org: ${event.organization})` +
+                `${event.repo ? ` from ${event.repo}@${event.branch ?? "main"}` : ""}` +
+                `${event.url ? ` → ${event.url}` : ""}\n`);
             break;
         case "project_linked":
-            process.stdout.write(`→ Project ${event.slug}\n`);
+            process.stdout.write(`→ Project ${event.slug}${event.url ? `  ${event.url}` : ""}\n`);
+            if (event.status === "pending_setup") {
+                process.stdout.write("  проект в pending_setup: `layero deploy` загрузит код и применит настройку\n");
+            }
             break;
         case "detected":
             process.stdout.write(event.runtime_kind
@@ -193,6 +198,129 @@ function renderHuman(event) {
         case "promoted":
             process.stdout.write(`✓ Published apex → ${event.url}\n`);
             break;
+        case "me":
+            process.stdout.write(`id:       ${event.id}\n`);
+            process.stdout.write(`username: ${event.username ?? "(не задано)"}\n`);
+            process.stdout.write(`email:    ${event.email ?? "(нет)"}\n`);
+            if (event.github_login)
+                process.stdout.write(`github:   ${event.github_login}\n`);
+            break;
+        case "logged_out":
+            process.stdout.write(`✓ Выход выполнен (удалён ${event.config_path})\n`);
+            break;
+        case "projects":
+            if (event.projects.length === 0) {
+                process.stdout.write("Проектов пока нет — `layero deploy` создаст первый.\n");
+                break;
+            }
+            for (const p of event.projects) {
+                const tag = p.source_type === "cli" ? "[cli]" : "[git]";
+                process.stdout.write(`${tag} ${p.slug}  ${p.id}  ${p.url}\n`);
+            }
+            break;
+        case "organizations":
+            if (event.organizations.length === 0) {
+                process.stdout.write("У аккаунта нет организаций.\n");
+                break;
+            }
+            for (const o of event.organizations) {
+                process.stdout.write(`  ${o.slug.padEnd(20)} ${o.kind}  (${o.role})\n`);
+            }
+            break;
+        case "hooks":
+            if (event.hooks.length === 0) {
+                process.stdout.write("Хуков пока нет — `layero hooks create <имя>` заведёт первый.\n");
+                break;
+            }
+            for (const h of event.hooks) {
+                const last = h.last_triggered_at ? `срабатывал ${h.last_triggered_at}` : "не срабатывал";
+                process.stdout.write(`[${h.target}] ${h.name}  branch=${h.branch ?? "default"}  (${last})\n` +
+                    `        ${h.id}\n        ${h.url}\n`);
+            }
+            break;
+        case "hook_created":
+            process.stdout.write(`✓ Хук [${event.target}] ${event.name}\n  ${event.id}\n  ${event.url}\n`);
+            process.stdout.write("\n  Вставьте адрес в CMS / cron / внешний CI как POST-вебхук. " +
+                "Любой, у кого он есть, запускает сборку — храните как секрет; " +
+                "ротация: delete + create.\n");
+            break;
+        case "hook_deleted":
+            process.stdout.write(`✓ Хук ${event.id} отозван\n`);
+            break;
+        case "init_done":
+            for (const d of event.agent_docs) {
+                const mark = d.result === "created" ? "✓ создан" : d.result === "updated" ? "✓ обновлён" : "= без изменений";
+                process.stdout.write(`  ${mark} ${d.file}\n`);
+            }
+            process.stdout.write(`  ${event.project_json === "created" ? "✓ создан" : "= без изменений"} .layero/project.json\n`);
+            process.stdout.write("\nДальше:\n  $ npx layero@latest login    # один раз, в браузере\n  $ npx layero@latest deploy   # выложить текущую папку\n");
+            break;
+        case "sources":
+            process.stdout.write(`Провайдеры (${event.org}):\n`);
+            for (const p of event.providers) {
+                const flags = [p.self_hosted ? "свой инстанс" : null, p.webhook_supported ? null : "без вебхуков"]
+                    .filter(Boolean)
+                    .join(", ");
+                process.stdout.write(`  ${p.id.padEnd(12)} ${p.title}${flags ? `  (${flags})` : ""}\n`);
+            }
+            process.stdout.write("Подключения:\n");
+            if (event.connections.length === 0) {
+                process.stdout.write("  нет — `layero sources connect <provider> --token-stdin`\n");
+            }
+            for (const c of event.connections) {
+                process.stdout.write(`  ${c.id}  ${c.provider.padEnd(12)} ${c.account ?? "—"}  ${c.status}` +
+                    `  проектов: ${c.projects_count}${c.last_error ? `  ! ${c.last_error}` : ""}\n`);
+            }
+            break;
+        case "source_connected":
+            process.stdout.write(`✓ Подключён ${event.provider}${event.account ? ` (${event.account})` : ""}: ${event.connection_id}\n`);
+            break;
+        case "source_repos":
+            if (event.repos.length === 0) {
+                process.stdout.write("Токену не видно ни одного репозитория.\n");
+                break;
+            }
+            for (const r of event.repos) {
+                process.stdout.write(`  ${r.path.padEnd(40)} ${r.default_branch.padEnd(10)} ${r.private ? "private" : "public"}\n`);
+            }
+            break;
+        case "webhook_installed":
+            process.stdout.write(`✓ Вебхук установлен — push в репозиторий запускает сборку\n`);
+            break;
+        case "webhook_unavailable":
+            process.stdout.write(`! Вебхук не установлен: ${event.hint}\n  Адрес для ручной настройки: ${event.url}\n`);
+            break;
+        case "environments":
+            if (event.environments.length === 0) {
+                process.stdout.write("Окружений пока нет — сначала `layero deploy` или push в репозиторий.\n");
+                break;
+            }
+            for (const e of event.environments) {
+                const mark = e.production ? "★" : " ";
+                const when = e.active_deploy_at ? `  ${e.active_deploy_at}` : "  (нет активного деплоя)";
+                process.stdout.write(`${mark} ${e.branch.padEnd(24)} ${e.url}${when}\n`);
+            }
+            break;
+        case "project_deleted":
+            process.stdout.write(`✓ Проект ${event.slug} удалён (очистка ресурсов идёт в фоне)\n`);
+            break;
+        case "claimable":
+            process.stdout.write(`→ Временный проект ${event.slug}: ${event.url}\n`);
+            process.stdout.write(`  Сайт живёт до ${event.expires_at} (72 часа). Забрать в аккаунт: ${event.claim_url}\n`);
+            break;
+        case "claim_status":
+            process.stdout.write(`Код ${event.code}: ${event.status}${event.claimed ? " (забран)" : ""}` +
+                `${event.expires_at ? `, действует до ${event.expires_at}` : ""}\n`);
+            if (event.url)
+                process.stdout.write(`  сайт: ${event.url}\n`);
+            if (event.claim_url && !event.claimed)
+                process.stdout.write(`  забрать: ${event.claim_url}\n`);
+            break;
+        case "claim_accept":
+            process.stdout.write(event.opened
+                ? `→ Открыл ${event.claim_url} — подтвердите в панели\n`
+                : `→ Откройте в браузере и подтвердите в панели: ${event.claim_url}\n`);
+            break;
         case "error":
             process.stderr.write(`Error: ${event.code}\n`);
             process.stderr.write(`  ${event.message}\n`);

package/dist/api.js

@@ -1,4 +1,6 @@
+import { LayeroError } from "./agent.js";
 import { CLI_VERSION, userAgent } from "./version.js";
+import { looksLikeId } from "./project-ref.js";
 export class ApiError extends Error {
     status;
     body;
@@ -57,6 +59,31 @@ export class ApiClient {
     getProject(idOrSlug) {
         return this.request("GET", `/projects/${idOrSlug}`);
     }
+    /**
+     * Проект по идентификатору ИЛИ по слагу — так, как обещают справки команд.
+     *
+     * 🚨 РЕЗОЛВ ЖИВЁТ ЗДЕСЬ, А НЕ НА СЕРВЕРЕ, и это не лень. Слаг проекта
+     * уникален В ПРЕДЕЛАХ ОРГАНИЗАЦИИ (`projects_owner_slug_uniq` — пара
+     * organization_id + slug), то есть один и тот же слаг законно существует у
+     * двух организаций сразу. Ручка `/projects/{id}` организации не знает и
+     * выбирать между ними не имеет права; клиент знает, за кого он ходит.
+     *
+     * Отличаем по ФОРМЕ значения: UUID, ушедший в поиск по слагу, не нашёлся бы.
+     * Раньше отличия не было вовсе — слаг уезжал в путь как есть, и ручка
+     * отвечала 422 `uuid_parsing`, а CLI показывал его как «internal, сообщите
+     * об ошибке» (T-20260909-32).
+     */
+    async resolveProject(idOrSlug) {
+        if (looksLikeId(idOrSlug))
+            return this.getProject(idOrSlug);
+        const projects = await this.listProjects();
+        const found = projects.find((p) => p.slug === idOrSlug);
+        if (!found) {
+            const known = projects.map((p) => p.slug).slice(0, 8).join(", ");
+            throw new LayeroError("project_unknown", `проекта «${idOrSlug}» нет среди доступных`, known ? `есть такие: ${known}` : "заведите проект: layero deploy");
+        }
+        return found;
+    }
     createCliProject(input) {
         return this.request("POST", "/projects", {
             name: input.name,
@@ -194,6 +221,39 @@ export class ApiClient {
     dataEnv(projectId) {
         return this.request("GET", `/projects/${projectId}/data-env`);
     }
+    // ── Data API базы: ключи, сайты, методы и уровни (T-20260911-9) ─────────
+    //
+    // Те же ручки, что у раздела «API» в панели. Ответы у них без модели в
+    // схеме, поэтому их форма описана здесь; тела запросов — из схемы.
+    listDataKeys(org, dbId) {
+        return this.request("GET", `/organizations/${org}/databases/${dbId}/api/keys`);
+    }
+    issueDataKey(org, dbId, input) {
+        return this.request("POST", `/organizations/${org}/databases/${dbId}/api/keys`, input);
+    }
+    revokeDataKey(org, dbId, keyId) {
+        return this.request("DELETE", `/organizations/${org}/databases/${dbId}/api/keys/${keyId}`);
+    }
+    listDataOrigins(org, dbId) {
+        return this.request("GET", `/organizations/${org}/databases/${dbId}/api/origins`);
+    }
+    addDataOrigin(org, dbId, origin, note) {
+        const body = { origin, note };
+        return this.request("POST", `/organizations/${org}/databases/${dbId}/api/origins`, body);
+    }
+    /** Источник — параметром запроса: в нём `://` и точки, путём он стал бы чужим маршрутом. */
+    removeDataOrigin(org, dbId, origin) {
+        return this.request("DELETE", `/organizations/${org}/databases/${dbId}/api/origins?origin=${encodeURIComponent(origin)}`);
+    }
+    listDataMethods(org, dbId) {
+        return this.request("GET", `/organizations/${org}/databases/${dbId}/api/methods`);
+    }
+    setDataLevels(org, dbId, input) {
+        return this.request("POST", `/organizations/${org}/databases/${dbId}/api/levels`, input);
+    }
+    enableDataApi(org, dbId, withSecret) {
+        return this.request("POST", `/organizations/${org}/databases/${dbId}/api/enable?with_secret=${withSecret ? "true" : "false"}`);
+    }
     /**
      * Значение `null` = «оставить как есть». Благодаря этому добавить одну
      * переменную можно, не читая остальные, — то есть не имея доступа к
@@ -292,6 +352,71 @@ export class ApiClient {
     checkUsername(value) {
         return this.request("GET", `/auth/me/username/check?value=${encodeURIComponent(value)}`);
     }
+    /**
+     * Проба метода Data API настоящим запросом через шлюз; запись откатывается
+     * (T-20260911-1). Ответ шлюза, в том числе его отказ, приходит телом 200.
+     */
+    probeDataApi(org, dbId, input) {
+        return this.request("POST", `/organizations/${org}/databases/${dbId}/api/probe-http`, input);
+    }
+    // --- Источники кода: провайдеры, подключения, репозитории (этап 6). ------
+    listSourceProviders(org) {
+        return this.request("GET", `/organizations/${org}/source-providers`);
+    }
+    listSourceConnections(org) {
+        return this.request("GET", `/organizations/${org}/source-connections`);
+    }
+    /** Токен уходит на сервер и НЕ возвращается: ответ — подключение без него. */
+    createSourceConnection(org, input) {
+        return this.request("POST", `/organizations/${org}/source-connections`, input);
+    }
+    listSourceRepos(org, connectionId) {
+        return this.request("GET", `/organizations/${org}/source-connections/${connectionId}/repos`);
+    }
+    /** Аккаунты, из которых организация может импортировать: GitHub App и токеновые подключения. */
+    listImportAccounts(org) {
+        return this.request("GET", `/organizations/${org}/import/accounts`);
+    }
+    listImportRepos(org, accountKey) {
+        return this.request("GET", `/organizations/${org}/import/repos?account=${encodeURIComponent(accountKey)}`);
+    }
+    /**
+     * Проект из репозитория GitHub через ключ аккаунта (`github:<installation>`):
+     * сервер сам заводит проект и вебхук — у GitHub App иного режима нет.
+     */
+    createProjectFromAccount(input) {
+        return this.request("POST", "/projects", {
+            name: input.name,
+            source_type: "github",
+            organization_slug: input.organization_slug,
+            source_account_key: input.source_account_key,
+            repo_path: input.repo_path,
+            default_branch: input.default_branch ?? "main",
+        });
+    }
+    /**
+     * Привязать репозиторий внешнего провайдера к существующему проекту.
+     * Возвращает и итог вебхука: у GitVerse/GitLab/GitFlic его может не дать
+     * токен, у SourceCraft вебхуков нет вовсе — привязка при этом остаётся.
+     */
+    connectSource(projectId, input) {
+        return this.request("POST", `/projects/${projectId}/connect-source`, input);
+    }
+    /** Окружения проекта: ветки с адресами. Архивные и снятые с раздачи не входят. */
+    listBranches(projectId) {
+        return this.request("GET", `/projects/${projectId}/branches`);
+    }
+    /** Требует scope `admin` у токена: удаление необратимо. */
+    deleteProject(projectId) {
+        return this.request("DELETE", `/projects/${projectId}`);
+    }
+    // --- Claimable (этап 13). Без токена: заявку создаёт кто угодно. ----------
+    createClaimableProject(input) {
+        return this.request("POST", "/claimable/projects", input);
+    }
+    getClaimStatus(code) {
+        return this.request("GET", `/claimable/status?code=${encodeURIComponent(code)}`);
+    }
 }
 export async function uploadArchive(init, filePath) {
     const fs = await import("node:fs");

package/dist/bin/layero.js

@@ -3,7 +3,11 @@ import { Command } from "commander";
 import chalk from "chalk";
 import { whoamiCmd } from "../commands/whoami.js";
 import { logoutCmd } from "../commands/logout.js";
-import { projectsListCmd } from "../commands/projects.js";
+import { projectsCreateCmd, projectsDeleteCmd, projectsListCmd } from "../commands/projects.js";
+import { sourcesConnectCmd, sourcesListCmd, sourcesReposCmd } from "../commands/sources.js";
+import { envsListCmd } from "../commands/envs.js";
+import { claimAcceptCmd, claimStatusCmd } from "../commands/claim.js";
+import { exitCodeFor } from "../exit-codes.js";
 import { linkCmd } from "../commands/link.js";
 import { tokenCreateCmd, tokenListCmd, tokenRevokeCmd, tokenSetCmd } from "../commands/token.js";
 import { deployCmd } from "../commands/deploy.js";
@@ -16,6 +20,7 @@ import { initCmd } from "../commands/init.js";
 import { diagnoseCmd, logsCmd } from "../commands/diagnose.js";
 import { perfCheckCmd, perfShowCmd } from "../commands/perf.js";
 import { dataEnvCmd } from "../commands/data.js";
+import { registerDataApiCommands } from "../commands/data-api.js";
 import { dbConnectCmd, dbCreateCmd, dbDisconnectCmd, dbListCmd, dbSqlCmd, } from "../commands/db.js";
 import { envListCmd, envSetCmd, envUnsetCmd } from "../commands/env.js";
 import { analyticsConnectCmd, analyticsDisconnectCmd, analyticsStatsCmd, analyticsStatusCmd, } from "../commands/analytics.js";
@@ -82,17 +87,82 @@ async function main() {
     });
     const projects = program
         .command("projects")
-        .description("Inspect projects on your account.");
+        .description("Проекты аккаунта: список, создание из репозитория, удаление.");
     projects
         .command("list")
-        .description("List your projects.")
+        .description("Список ваших проектов.")
         .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>", "организация (по умолчанию единственная)")
+        .addHelpText("after", "\nПримеры:\n" +
+        "  $ layero projects create --repo github:acme/site\n" +
+        "  $ layero projects create --repo gitverse:acme/site --branch develop --json\n" +
+        "\nСобытия в --json: project_created, source_connected, webhook_installed | webhook_unavailable.\n" +
+        "Без вебхука push не собирается — заведите его вручную по адресу из 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", "не спрашивать подтверждение (вне терминала — обязателен)")
+        .action(async (ref, opts) => projectsDeleteCmd(ref, { ...opts, json: program.opts().json }));
+    const sources = program
+        .command("sources")
+        .description("Git-провайдеры организации: какие есть, подключить по токену, посмотреть репозитории.");
+    sources
+        .command("list")
+        .description("Провайдеры платформы и подключения организации.")
+        .option("--org <slug>", "организация (по умолчанию единственная)")
+        .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" +
+        "  $ 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 в панели.")
+        .action(async (provider, opts) => sourcesConnectCmd(provider, { ...opts, json: program.opts().json }));
+    sources
+        .command("repos <connection_id>")
+        .description("Репозитории, видимые токену подключения.")
+        .option("--org <slug>", "организация (по умолчанию единственная)")
+        .action(async (id, opts) => sourcesReposCmd(id, { ...opts, json: program.opts().json }));
+    const envs = program
+        .command("envs")
+        .description("Окружения проекта: ветки и их адреса.");
+    envs
+        .command("list")
+        .description("Окружения проекта с адресами. У CLI-проекта одно — `cli`; у проекта с репозиторием — по ветке.")
+        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
+        .action(async (opts) => envsListCmd({ ...opts, json: program.opts().json }));
+    const claim = program
+        .command("claim")
+        .description("Проект без аккаунта (`layero deploy --claim`): статус заявки и ссылка, чтобы забрать сайт.");
+    claim
+        .command("status [code]")
+        .description("Состояние заявки: жива, забрана, истекла. Без кода — из .layero/project.json.")
+        .action(async (code) => claimStatusCmd(code, { json: program.opts().json }));
+    claim
+        .command("accept [code]")
+        .description("Открыть страницу заявки в панели. Принять её может только человек, вошедший в панель, — CLI лишь открывает или печатает ссылку.")
+        .option("--no-browser", "не открывать браузер — только напечатать ссылку")
+        .action(async (code, opts) => claimAcceptCmd(code, { ...opts, json: program.opts().json }));
     const orgs = program
         .command("orgs")
-        .description("Layero organizations on your account (personal + teams).");
+        .description("Организации аккаунта: личная и команды.");
     orgs
         .command("list")
-        .description("Show every Layero organization you belong to.")
+        .description("Все организации, в которых вы состоите.")
         .action(orgsListCmd);
     const deploys = program
         .command("deploys")
@@ -114,13 +184,7 @@ async function main() {
         .description("List deploy hooks for the linked project.")
         .option("--project <id>", "target project id (default: linked .layero/project.json)")
         .action(async (opts) => {
-        try {
-            await hooksListCmd(opts);
-        }
-        catch (err) {
-            console.error(String(err?.message ?? err));
-            process.exitCode = 1;
-        }
+        await hooksListCmd(opts);
     });
     hooks
         .command("create <name>")
@@ -134,26 +198,14 @@ async function main() {
         + "  $ layero hooks create publish --prod        # production-target hook for default branch\n"
         + "  $ layero hooks create staging --branch=dev  # any branch, preview environment")
         .action(async (name, opts) => {
-        try {
-            await hooksCreateCmd(name, opts);
-        }
-        catch (err) {
-            console.error(String(err?.message ?? err));
-            process.exitCode = 1;
-        }
+        await hooksCreateCmd(name, opts);
     });
     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)")
         .action(async (id, opts) => {
-        try {
-            await hooksDeleteCmd(id, opts);
-        }
-        catch (err) {
-            console.error(String(err?.message ?? err));
-            process.exitCode = 1;
-        }
+        await hooksDeleteCmd(id, opts);
     });
     program
         .command("promote [deploy]")
@@ -203,7 +255,7 @@ async function main() {
         .option("-y, --yes", "не спрашивать подтверждение")).action(async (keys, opts) => envUnsetCmd(keys, { ...opts, json: program.opts().json }));
     const data = program
         .command("data")
-        .description("Data API: адрес и публичный ключ базы для фронтенда.");
+        .description("Data API базы: ключи, сайты, методы и доступ; адрес и ключ для фронтенда.");
     data
         .command("env")
         .description("Показать VITE_/NEXT_PUBLIC_ переменные Data API; --write кладёт их в .env.local.")
@@ -216,6 +268,7 @@ async function main() {
         "\nОтдаётся только ПУБЛИЧНЫЙ ключ — тот, что и так уезжает в бандл.\n" +
         "Секретный ключ платформа не хранит и не отдаёт: он для сервера.")
         .action(async (opts) => dataEnvCmd({ ...opts, json: program.opts().json }));
+    registerDataApiCommands(data, program);
     const db = program
         .command("db")
         .description("Базы организации: завести, посмотреть, подключить к проекту, выполнить SQL.");
@@ -378,10 +431,11 @@ async function main() {
         .option("--root <dir>", "monorepo: subdirectory inside the repo that the builder treats as the app root (saved on the project; future GitHub-push and hook triggers use the same value)")
         .option("--prod", "deploy to production (replaces apex_hostname's active deploy). Without this flag, deploys go to the project's CLI preview pseudo-branch.")
         .option("--promote", "pin the project apex to this deploy after a successful build (V071). Works for any branch — e.g. `--promote` without --prod publishes a CLI preview straight to production.")
-        .option("--branch <name>", "ACCEPTED BUT IGNORED for direct uploads: the backend files every " +
-        "archive deploy under the reserved `cli` environment. Branch " +
-        "environments come from pushes to a connected repository, not from " +
-        "this flag. Kept for backwards compatibility.")
+        .option("--branch <name>", "REFUSED (branch_unsupported, exit 4): archive uploads always land in the " +
+        "reserved `cli` environment, so this flag cannot give you a preview. " +
+        "Branch previews come from pushing to a connected repository.")
+        .option("--claim", "deploy without an account: a temporary project for 72 hours plus a claim_url for a human to take it over. " +
+        "Turns on by itself when there is no token, the run is non-interactive (agent, not CI) and --yes is passed.")
         .option("--org <slug>", "Layero organization slug for first-time project creation. Defaults to personal; required when you're a member of multiple orgs and want a non-personal home.")
         // Осознанное подтверждение выкатки, когда предыдущие сборки подряд падают
         // с ОДНОЙ И ТОЙ ЖЕ ошибкой. Намеренно НЕ покрывается `--yes`: смысл стопа
@@ -393,7 +447,7 @@ async function main() {
         "  $ layero deploy --prod               # production deploy (interactive confirm)\n" +
         "  $ layero deploy --prod --yes         # production deploy, no prompt (CI)\n" +
         "  $ layero deploy --promote            # preview deploy + pin apex (one-shot publish)\n" +
-        "  $ layero deploy --branch=staging     # preview on a specific branch\n" +
+        "  $ layero deploy --claim              # no account: temporary site + claim link\n" +
         "  $ layero deploy --type vite          # force a framework preset\n" +
         "  $ layero deploy --type express       # Node backend: platform RUNS it, not serves files\n" +
         "  $ layero deploy --json               # machine-readable output for agents")
@@ -506,7 +560,11 @@ main().catch((err) => {
     if (debug && err instanceof Error && err.stack) {
         console.error(chalk.dim(err.stack));
     }
+    // Класс выхода — по коду ошибки (`exit-codes.ts`): 2 вход, 3 не найдено,
+    // 4 неверный ввод, 5 удалённая ошибка, 1 прочее.
+    let exitCode = 1;
     if (err instanceof LayeroError) {
+        exitCode = exitCodeFor(err.code);
         emit({
             event: "error",
             code: err.code,
@@ -515,6 +573,7 @@ main().catch((err) => {
         });
     }
     else {
+        exitCode = exitCodeFor("internal");
         // Anything else (network error, unexpected exception) — still emit
         // a structured error so agents have a consistent format to parse.
         const message = err?.message ?? String(err);
@@ -535,5 +594,5 @@ main().catch((err) => {
             }
         }
     }
-    process.exit(1);
+    process.exit(exitCode);
 });