layero 0.10.1 → 0.10.2

package/README.md

@@ -74,7 +74,7 @@ The first `layero deploy` in a directory creates a project and links it via
 | `layero login` / `logout` / `whoami` | Browser device-flow sign-in, sign-out, current account. |
 | `layero deploy` | Pack the current directory, build on the platform, publish. `--claim` — without an account. |
 | `layero projects list` | Projects on your account with addresses. |
-| `layero projects create --repo <provider>:<owner/repo>` | Create a project from a repository of a connected provider. Events: `project_created`, `source_connected`, `webhook_installed` \| `webhook_unavailable`. |
+| `layero projects create --repo <provider>:<owner/repo>` | Create a project from a repository of a connected provider, apply the detected settings and start the first build (what the dashboard's "Start deploy" button does); `--no-deploy` leaves it in the wizard. Events: `project_created`, `source_connected`, `webhook_installed` \| `webhook_unavailable`, then `setup_applied` + `deploy_started` \| `setup_pending` \| `setup_failed`. |
 | `layero projects delete <slug> --yes` | Delete a project. Irreversible; needs a token with scope `admin`. |
 | `layero sources list` | Git providers the platform supports and the organization's connections. |
 | `layero sources connect <provider> --token-stdin` | Connect a provider by personal access token (read from stdin so it never lands in shell history). |
@@ -196,6 +196,14 @@ SourceCraft, which has no outgoing webhooks), the CLI says so with
 `webhook_unavailable` and the URL to register by hand — the repository is
 connected either way, only push-triggered builds wait for the webhook.
 
+Once linked, the command finishes the setup wizard itself: it takes the
+detection hint (framework, build command, output directory), applies it and
+starts the first build — exactly what the dashboard's "Start deploy" button
+does (`setup_applied`, `deploy_started`). `--no-deploy` leaves the project in
+the wizard (`setup_pending` with the dashboard URL). If detection or setup
+fails, the project is still created and the exit code is 0: `setup_failed`
+carries the reason and the wizard URL.
+
 ## Deploy hooks — webhook URLs that trigger builds
 
 ```bash
@@ -270,7 +278,9 @@ Every command emits events — one JSON object per line on stdout:
 {"event":"project_created","project_id":"…","slug":"…","organization":"…","url":"…","repo":"…","branch":"…"}
 {"event":"project_linked","project_id":"…","slug":"…","url":"…"}
 {"event":"source_connected","org":"…","connection_id":"…","provider":"…","account":"…"}
-{"event":"webhook_installed","project":"…","url":"…"}   |   {"event":"webhook_unavailable","project":"…","url":"…","hint":"…"}
+{"event":"webhook_installed","project":"…"}   |   {"event":"webhook_unavailable","project":"…","url":"…","hint":"…"}
+{"event":"setup_applied","project":"…","framework":"…","build_cmd":"…","output_dir":"…","layero_found":false}
+{"event":"setup_pending","project":"…","url":"https://app.layero.ru/projects/…/setup","hint":"…"}   |   {"event":"setup_failed","project":"…","reason":"…","url":"…","hint":"…"}
 {"event":"sources","org":"…","providers":[…],"connections":[…]}
 {"event":"source_repos","org":"…","connection_id":"…","repos":[…]}
 {"event":"environments","project":"…","environments":[{"branch":"main","url":"https://…","production":true,…}]}

package/dist/agent.js

@@ -144,7 +144,13 @@ function renderHuman(event) {
             // intentionally quiet in human mode — the next stage line takes over
             break;
         case "setup_applied":
-            process.stdout.write(`✓ Setup applied\n`);
+            process.stdout.write(event.framework ? `✓ Setup applied (${event.framework})\n` : `✓ Setup applied\n`);
+            break;
+        case "setup_pending":
+            process.stdout.write(`· Проект ждёт настройки в панели: ${event.url}\n`);
+            break;
+        case "setup_failed":
+            process.stdout.write(`! ${event.hint}\n  Причина: ${event.reason}\n`);
             break;
         case "preview_evicted": {
             // Предупреждение, а не отчёт: перестал отвечать адрес, который кому-то

package/dist/api.js

@@ -402,6 +402,29 @@ export class ApiClient {
     connectSource(projectId, input) {
         return this.request("POST", `/projects/${projectId}/connect-source`, input);
     }
+    /**
+     * Подсказка детекта для проекта с репозиторием — то, что панель показывает
+     * в мастере: фреймворк, команда сборки, папка результата, менеджер пакетов,
+     * найден ли `layero.json`.
+     */
+    detectProject(projectId) {
+        return this.request("GET", `/projects/${projectId}/detect`);
+    }
+    /**
+     * Завершить мастер за человека: та же ручка, что у кнопки «Начать деплой»
+     * в панели. Обязателен только `framework_hint`; остальное — то, что дал
+     * детект. Не заданное здесь не заглушка, а «решит сборщик по репозиторию».
+     */
+    applySetup(projectId, input) {
+        return this.request("POST", `/projects/${projectId}/setup`, input);
+    }
+    /**
+     * Первая сборка проекта с репозиторием: без архива — сервер сам берёт HEAD
+     * ветки по умолчанию. Панель после мастера делает ровно этот вызов.
+     */
+    triggerRepoDeploy(projectId) {
+        return this.request("POST", `/projects/${projectId}/deploy`, {});
+    }
     /** Окружения проекта: ветки с адресами. Архивные и снятые с раздачи не входят. */
     listBranches(projectId) {
         return this.request("GET", `/projects/${projectId}/branches`);

package/dist/bin/layero.js

@@ -100,10 +100,14 @@ async function main() {
         .option("--branch <name>", "основная ветка (по умолчанию — ветка репозитория по умолчанию)")
         .option("--name <name>", "имя проекта (по умолчанию — имя репозитория)")
         .option("--org <slug>", "организация (по умолчанию единственная)")
+        .option("--no-deploy", "не применять настройки и не запускать первую сборку — проект останется в мастере панели")
         .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" +
+        "\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.")
         .action(async (opts) => projectsCreateCmd({ ...opts, json: program.opts().json }));
     projects

package/dist/commands/projects.js

@@ -1,6 +1,7 @@
 import readline from "node:readline/promises";
 import { ApiClient, ApiError } from "../api.js";
 import { loadConfig } from "../config.js";
+import { dashboardOrigin } from "../urls.js";
 import { LayeroError, detectMode, emit } from "../agent.js";
 import { orgOf } from "./db.js";
 async function makeClient() {
@@ -95,7 +96,10 @@ export async function projectsCreateCmd(opts) {
         emitCreated(project, repo.path, branch);
         emit({ event: "source_connected", org, connection_id: account.key, provider, account: account.login });
         // У GitHub App вебхук — часть установки: без него App не существует.
-        emit({ event: "webhook_installed", project: project.slug, url: "" });
+        // Отдельного адреса у него нет, и пустая строка в `url` читалась бы как
+        // «адрес потерян» — поля нет вовсе.
+        emit({ event: "webhook_installed", project: project.slug });
+        await finishSetup(api, project, opts);
         return;
     }
     const connectionId = account.key.replace(/^connection:/, "");
@@ -138,6 +142,110 @@ export async function projectsCreateCmd(opts) {
                 "провайдер не дал создать вебхук этим токеном — заведите его в настройках репозитория вручную",
         });
     }
+    await finishSetup(api, connected.project, opts);
+}
+/** Адрес мастера проекта в панели — туда идёт человек, если мы не смогли. */
+async function setupUrl(project) {
+    const cfg = await loadConfig();
+    return `${dashboardOrigin(cfg.apiUrl)}/projects/${project.id}/setup`;
+}
+/** Рантайм, который панель ставит проекту ДО первой сборки; статика — как есть. */
+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` из подсказки детекта — так же, как его собирает мастер панели.
+ *
+ * Пишем только то, что детект действительно дал: пустое поле — не заглушка,
+ * а «решит сборщик по репозиторию» (правило 3 `core/docs/BUILD-CONFIG.md`).
+ * Менеджер пакетов закрепляем только из `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;
+    if (d.layero_found && d.package_manager && PACKAGE_MANAGERS.has(d.package_manager)) {
+        payload.package_manager = d.package_manager;
+    }
+    if (d.suggested_root_directory)
+        payload.root_directory = d.suggested_root_directory;
+    return payload;
+}
+/**
+ * Завершить мастер и запустить первую сборку — то, что панель делает по
+ * кнопке «Начать деплой». До 0.10.2 команда на этом останавливалась:
+ * проект оставался в `pending_setup`, первая сборка ждала клика в панели, а
+ * агент без панели узнавал об этом только по вечному «сборок ещё не было».
+ *
+ * Сбой детекта или настройки создание НЕ роняет: проект уже есть, адрес
+ * занят, и правильный исход — сказать «доделайте в панели» и выйти нулём.
+ */
+async function finishSetup(api, project, opts) {
+    const panel = await setupUrl(project);
+    if (opts.deploy === false) {
+        emit({ event: "setup_pending", project: project.slug, url: panel, hint: "проект ждёт настройки в мастере панели" });
+        return;
+    }
+    let detected;
+    let payload;
+    try {
+        detected = await api.detectProject(project.id);
+        payload = setupPayloadFromDetect(detected);
+        await api.applySetup(project.id, payload);
+    }
+    catch (err) {
+        const reason = err instanceof ApiError ? err.body.slice(0, 300) : String(err);
+        emit({
+            event: "setup_failed",
+            project: project.slug,
+            reason,
+            url: panel,
+            hint: `проект создан, но настроить его не вышло — завершите в панели: ${panel}`,
+        });
+        return;
+    }
+    emit({
+        event: "setup_applied",
+        project: project.slug,
+        framework: payload.framework_hint,
+        build_cmd: payload.build_cmd ?? null,
+        output_dir: payload.output_dir ?? null,
+        layero_found: detected.layero_found,
+    });
+    // Приложение, а не статика: тип — до первой сборки, иначе сборщик падает на
+    // детекте («похоже на ssr_next, а настроено как spa»). Возражение сервера
+    // (409) сборку не запирает: это подсказка детекта, а не выбор человека.
+    const kind = detected.runtime_kind ?? null;
+    if (kind && RUNTIME_KINDS.has(kind) && project.project_type !== kind) {
+        try {
+            await api.setRuntimeType(project.id, kind);
+            emit({ event: "runtime_type_applied", project_type: kind });
+        }
+        catch {
+            /* сборщик переставит тип сам, если репозиторий его подтвердит */
+        }
+    }
+    try {
+        const deploy = await api.triggerRepoDeploy(project.id);
+        emit({ event: "deploy_started", project: project.slug, deploy_id: deploy.id, url: `https://${project.apex_hostname}` });
+    }
+    catch (err) {
+        const reason = err instanceof ApiError ? err.body.slice(0, 300) : String(err);
+        emit({
+            event: "setup_failed",
+            project: project.slug,
+            reason,
+            url: panel,
+            hint: `настройки применены, но первая сборка не запустилась — запустите в панели: ${panel}`,
+        });
+    }
 }
 function emitCreated(project, repo, branch) {
     emit({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layero",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "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",