layero 0.10.5 → 0.11.1

package/dist/commands/deploy.js

@@ -9,7 +9,7 @@ import { loadConfig } from "../config.js";
 import { loadProjectConfig, persistProjectLinking, } from "../project-config.js";
 import { packCwd, packDirectory } from "../pack.js";
 import { streamDeployLogs } from "../logs.js";
-import { detectProject } from "../detect.js";
+import { detectProject, detectedEvent } from "../detect.js";
 import { runDeviceLogin } from "../auth.js";
 import { LayeroError, detectMode, emit, isCiEnv } from "../agent.js";
 import { ensureUsername } from "../username.js";
@@ -76,31 +76,23 @@ function projectUrl(apiUrl, projectId) {
     return `${dashboardOrigin(apiUrl)}/projects/${projectId}`;
 }
 /**
- * After a deploy reaches `ready`, ask the backend where it's actually
- * reachable. The builder marks status=ready *before* calling /activate
- * (which runs auto-promote + schedules CDN warmup), so a probe fired the
- * instant we see `ready` can race ahead of the apex pointer being set.
+ * After a deploy reaches `ready`, ask the backend for the canonical address
+ * of its environment (apex for the production env, the env host otherwise).
  *
- * Poll the probe briefly (bounded) and return as soon as the env is
- * reachable (`available` — the preview host is up) or we learn the CDN
- * edge is already warm. Best-effort: any error returns null and the caller
- * falls back to apex/dashboard URLs.
+ * One request, not a poll. The probe used to be polled for up to 15 s until
+ * its `available` flag turned true, and that flag also fed `edge_ready` — but
+ * it is the API's own view of the host, and the simulation of 18.09.2026 saw
+ * it stay false for 15 s on a static site that answered 200 at once. Whether
+ * the address serves the site is now measured directly (`waitUntilServing`).
+ * Best-effort: any error returns null and the caller falls back to the apex.
  */
 async function resolveReachability(api, environmentId) {
-    const deadline = Date.now() + 15_000;
-    let last = null;
-    while (Date.now() < deadline) {
-        try {
-            last = await api.probeEnvironment(environmentId);
-        }
-        catch {
-            return last; // permission/network — caller falls back
-        }
-        if (last.available || last.cdn_ready)
-            return last;
-        await new Promise((r) => setTimeout(r, 1500));
+    try {
+        return await api.probeEnvironment(environmentId);
+    }
+    catch {
+        return null; // permission/network — caller falls back
     }
-    return last;
 }
 async function prompt(question, fallback) {
     const rl = readline.createInterface({
@@ -188,54 +180,48 @@ async function resolvePrebuiltDir(cwd, raw) {
     }
     return dir;
 }
-// Resolve the framework / build / output config to send to completeSetup.
-// Precedence: explicit CLI args > .layero/project.json > auto-detect.
-async function resolveSetupConfig(cwd, opts, existing) {
+/**
+ * Заготовка `layero init` до 0.11: `static` / `true` / `.` без project_id.
+ * Эту тройку писал CLI, а не человек, — и она та самая догадка, от которой
+ * эта версия отказалась. Читать её как выбор значит тащить старую ошибку в
+ * новый проект.
+ */
+function isLegacyInitGuess(cfg) {
+    return Boolean(cfg &&
+        !cfg.project_id &&
+        cfg.framework_hint === "static" &&
+        cfg.build_cmd === "true" &&
+        cfg.output_dir === ".");
+}
+async function resolveSetupConfig(cwd, opts, existing, projectFramework) {
     // Honour --root when auto-detecting: the framework signals live in the
-    // monorepo subdir, not the repo root. Without this the detector sees
-    // a bare workspace package.json and falls through to "static".
+    // monorepo subdir, not the repo root.
     const detectCwd = opts.root ? path.join(cwd, opts.root) : cwd;
-    const detected = await detectProject(detectCwd);
-    emit({
-        event: "detected",
-        framework: detected.framework_hint,
-        build_cmd: detected.build_cmd,
-        output_dir: detected.output_dir,
-        confident: detected.confident,
-        ...(detected.runtime_kind ? { runtime_kind: detected.runtime_kind } : {}),
-        ...(detected.ssr_warning ? { ssr_warning: detected.ssr_warning } : {}),
-    });
     // ⚠️ Runtime-тип в `framework_hint` не уходит: это разные вопросы. Хинт
     // отвечает «чем собирать» (vite, next, …), а runtime-kind — «запускать или
     // раздавать файлами». Положи мы сюда `node_web`, сборщик получил бы имя
     // фреймворка, которого не существует.
     const asRuntime = runtimeTypeOf(opts.type);
-    const framework_hint = (asRuntime ? undefined : opts.type) ??
-        existing?.framework_hint ??
-        detected.framework_hint;
-    const build_cmd = existing?.build_cmd ?? detected.build_cmd;
-    const output_dir = existing?.output_dir ?? detected.output_dir;
-    let source;
-    if (existing?.build_cmd || existing?.output_dir || existing?.framework_hint) {
-        source =
-            existing?.build_cmd && existing?.output_dir && existing?.framework_hint
-                ? "config"
-                : "hybrid";
-    }
-    else {
-        source = "detected";
-    }
+    const typeHint = asRuntime ? null : (opts.type ?? null);
+    const own = isLegacyInitGuess(existing) ? null : existing;
+    const fileHint = own?.framework_hint ?? null;
+    const hint = typeHint ?? fileHint ?? projectFramework ?? null;
+    const detected = await detectProject(detectCwd, {
+        frameworkHint: hint,
+        hintSource: typeHint ? "--type" : fileHint ? ".layero/project.json" : "project settings",
+    });
+    emit(detectedEvent(detected));
     return {
-        framework_hint,
-        build_cmd,
-        output_dir,
-        source,
+        detected,
+        framework_hint: typeHint ?? fileHint,
+        build_cmd: own?.build_cmd ?? null,
+        output_dir: own?.output_dir ?? null,
         // Явный `--type` сильнее детекта: человек уже видел, как детект ошибся,
         // иначе бы не писал флаг.
         ...(asRuntime
-            ? { runtime_kind: asRuntime }
+            ? { runtime_kind: asRuntime, runtime_kind_origin: "user" }
             : detected.runtime_kind
-                ? { runtime_kind: detected.runtime_kind }
+                ? { runtime_kind: detected.runtime_kind, runtime_kind_origin: "detected" }
                 : {}),
     };
 }
@@ -352,6 +338,150 @@ async function startWithRepeatedFailureGuard(api, sessionId, commitSha, opts) {
             "`--confirm-repeated-failure`.");
     }
 }
+const RUNTIME_PROJECT_TYPES = new Set(["ssr_next", "streamlit", "gradio", "flask", "python_web", "node_web"]);
+/** У проекта подключён репозиторий: выкатка архива без `--prod` ляжет в
+ * окружение `cli`, а не на живой адрес. */
+function hasRepo(p) {
+    return Boolean(p?.repo_full_name && p.repo_status !== "disconnected");
+}
+/**
+ * `deploy --dry-run`: как платформа соберёт эту папку, если выкатить сейчас.
+ * Ничего не пакуется, не выгружается и не создаётся.
+ *
+ * 🚨 До 0.11 сухого прогона не было: единственным доказательством того, что
+ * платформа поняла папку, был лог настоящей сборки. Агент проверял форму
+ * приложения выкатками — а у проекта без репозитория каждая из них заменяет
+ * живой сайт (симуляция 18.09.2026, T-20260918-7).
+ *
+ * Порядок тот же, что у сборщика: `layero.json` > настройки проекта > детект.
+ * Настройки читаются, только если папка привязана к проекту и вход есть; без
+ * них план показывает то, что говорят файлы, и говорит об этом полем.
+ */
+async function dryRun(cwd, opts, existing, cliCfg) {
+    const ref = opts.project ?? (existing?.project_id || undefined);
+    let project = null;
+    let settings = "not linked";
+    if (ref) {
+        const token = cliCfg.token ?? claimTokenFor(cliCfg, existing?.project_id);
+        if (!token) {
+            settings = "not read: not logged in";
+        }
+        else {
+            try {
+                const api = new ApiClient({ ...cliCfg, token });
+                project = opts.project ? await api.resolveProject(opts.project) : await api.getProject(ref);
+                settings = "read";
+            }
+            catch (err) {
+                settings = `not read: ${err instanceof ApiError ? `API ${err.status}` : "network error"}`;
+            }
+        }
+    }
+    const root = opts.root ?? project?.root_directory ?? null;
+    const replacesLive = !project || !hasRepo(project) || Boolean(opts.prod || opts.promote);
+    const branchNote = opts.branch
+        ? `A real deploy refuses --branch (branch_unsupported): an upload always lands in the "cli" environment.`
+        : "";
+    const projectInfo = project
+        ? { id: project.id, slug: project.slug, project_type: project.project_type, repo: project.repo_full_name ?? null }
+        : null;
+    const prebuiltDir = await resolvePrebuiltDir(cwd, opts.prebuilt);
+    if (prebuiltDir) {
+        emit({
+            event: "plan",
+            framework: "static",
+            build_cmd: null,
+            output_dir: prebuiltDir,
+            runtime_kind: null,
+            root: null,
+            confident: true,
+            sources: { framework: "--prebuilt", build_cmd: "none", output_dir: "--prebuilt" },
+            project: projectInfo,
+            project_settings: settings,
+            creates_project: !ref,
+            replaces_live_site: replacesLive,
+            prebuilt_dir: prebuiltDir,
+            ...(branchNote ? { hint: branchNote } : {}),
+        });
+        return;
+    }
+    const setup = await resolveSetupConfig(cwd, { ...opts, root: root ?? undefined }, existing, project?.framework_hint ?? null);
+    const d = setup.detected;
+    let buildCmd = d.build_cmd;
+    let outputDir = d.output_dir;
+    const sources = { ...d.sources };
+    let runtimeKind = setup.runtime_kind ?? null;
+    // Настройки проекта исполняются дословно — поверх детекта, но под файлом.
+    // Статика не собирается, что бы ни лежало в поле команды.
+    if (project && !d.runtime_kind) {
+        if (project.build_cmd && d.framework_hint !== "static" && sources.build_cmd !== "layero.json") {
+            buildCmd = project.build_cmd;
+            sources.build_cmd = "project settings";
+        }
+        if (project.output_dir && sources.output_dir !== "layero.json") {
+            outputDir = project.output_dir;
+            sources.output_dir = "project settings";
+        }
+        if (RUNTIME_PROJECT_TYPES.has(project.project_type))
+            runtimeKind = project.project_type;
+    }
+    const hint = [d.hint, branchNote].filter(Boolean).join(" ");
+    emit({
+        event: "plan",
+        framework: d.framework_hint,
+        build_cmd: runtimeKind ? null : buildCmd,
+        output_dir: runtimeKind ? null : outputDir,
+        runtime_kind: runtimeKind,
+        root,
+        confident: d.confident,
+        sources,
+        project: projectInfo,
+        project_settings: settings,
+        creates_project: !ref,
+        replaces_live_site: replacesLive,
+        ...(hint ? { hint } : {}),
+        ...(d.next_action ? { next_action: d.next_action } : {}),
+        ...(d.candidates?.length ? { candidates: d.candidates } : {}),
+    });
+}
+// Сколько ждём, пока живой адрес начнёт отвечать приложением. Статика
+// отвечает с первого запроса; контейнеру нужно до ~20 с на запуск, и
+// симуляция 18.09.2026 видела 404-заглушку платформы уже после `ready`.
+const SERVE_WAIT_MS = 90_000;
+const SERVE_POLL_MS = 2_000;
+/**
+ * Дождаться, пока адрес перестанет отдавать экран платформы.
+ *
+ * Признак — заголовок `X-Layero-Screen`: его ставят ТОЛЬКО наши экраны
+ * («запускается», «здесь пока ничего нет», …), ответ сайта его не несёт.
+ * Тот же признак ждёт проба отклика платформы (`deploy_probe._await_edge`);
+ * время само по себе ничего не доказывает. До 0.11 CLI отдавал `ready`, как
+ * только сборка закончилась, и агенту приходилось опрашивать адрес самому —
+ * он узнавал это только из навыка (T-20260918-8).
+ */
+export async function waitUntilServing(url, budgetMs = SERVE_WAIT_MS) {
+    const deadline = Date.now() + budgetMs;
+    let screen;
+    for (;;) {
+        try {
+            const res = await fetch(url, {
+                headers: { "cache-control": "no-cache" },
+                redirect: "follow",
+                signal: AbortSignal.timeout(10_000),
+            });
+            screen = res.headers.get("x-layero-screen") ?? undefined;
+            await res.body?.cancel().catch(() => undefined);
+            if (!screen)
+                return { serving: true };
+        }
+        catch {
+            screen = "no response";
+        }
+        if (Date.now() + SERVE_POLL_MS > deadline)
+            return { serving: false, screen };
+        await new Promise((r) => setTimeout(r, SERVE_POLL_MS));
+    }
+}
 export async function deployCmd(opts) {
     const mode = detectMode();
     if (opts.type &&
@@ -367,9 +497,14 @@ export async function deployCmd(opts) {
     const cwd = process.cwd();
     let existing = await loadProjectConfig(cwd);
     let cliCfg = await loadConfig();
+    if (opts.dryRun) {
+        await dryRun(cwd, opts, existing, cliCfg);
+        return;
+    }
     // Claimable-проект этого запуска (этап 13): событие `claimable` уходит
     // перед `ready`, когда адрес сайта уже известен.
     let claimable = null;
+    let reusedClaim = null;
     // 🚨 ПЕСОЧНИЦА — ТОЛЬКО ДЛЯ НОВОГО ПРОЕКТА. `--project` или папка,
     // привязанная к проекту аккаунта, значат «выкатить в существующий», а у
     // токена песочницы прав на него нет: до 0.10.5 авто-режим всё равно
@@ -398,6 +533,10 @@ export async function deployCmd(opts) {
             : undefined;
         if (reuse) {
             cliCfg = { ...cliCfg, token: reuse };
+            // Повторная выкатка песочницы: ссылка «забрать» нужна агенту и здесь —
+            // без неё он искал её в `.layero/project.json` (симуляция 18.09.2026).
+            if (existing?.claim)
+                reusedClaim = existing.claim;
         }
         else if (
         // Явный `--claim` — всегда новая песочница (с `--project` он отклонён
@@ -463,13 +602,11 @@ export async function deployCmd(opts) {
     }
     // --- Всё, что требует файловой системы, делаем сами. Остальное — сервер.
     const prebuiltDir = await resolvePrebuiltDir(cwd, opts.prebuilt);
+    // Готовая сборка настроек проекту не пишет: сборщик у такой выкатки не
+    // запускается, а записанная `static` пережила бы её и заглушила следующую
+    // выкатку из исходников.
     const setup = prebuiltDir
-        ? {
-            framework_hint: "static",
-            build_cmd: "true",
-            output_dir: ".",
-            source: "prebuilt",
-        }
+        ? { framework_hint: null, build_cmd: null, output_dir: null }
         : await resolveSetupConfig(cwd, opts, existing);
     if (prebuiltDir) {
         emit({ event: "prebuilt", dir: prebuiltDir });
@@ -534,6 +671,7 @@ export async function deployCmd(opts) {
         build_cmd: setup.build_cmd,
         output_dir: setup.output_dir,
         runtime_kind: setup.runtime_kind,
+        runtime_kind_origin: setup.runtime_kind_origin,
         root_directory: opts.root ?? null,
         env_vars: existing?.env_vars ?? {},
         commit_message: prebuiltDir
@@ -621,12 +759,22 @@ export async function deployCmd(opts) {
         }
         emit({ event: "runtime_type_applied", project_type: wantType });
     }
+    else if (setup.runtime_kind &&
+        project.project_type === setup.runtime_kind &&
+        (session.created_project || claimable !== null)) {
+        // Новый проект получил тип в самой сессии, флипать нечего — но событие
+        // обещано документацией, и без него агент не узнаёт, что приложение будут
+        // ЗАПУСКАТЬ, а не раздавать файлами (симуляция 18.09.2026, `--type node_web`).
+        emit({ event: "runtime_type_applied", project_type: setup.runtime_kind });
+    }
+    // Только связка папки с проектом. Фреймворк сюда больше не пишется: поле
+    // этого файла CLI читает как выбор человека (см. `resolveSetupConfig`).
     await persistProjectLinking(cwd, {
         project_id: project.id,
         slug: project.slug,
         organization_slug: project.organization.slug,
         apex_hostname: project.apex_hostname,
-    }, setup.framework_hint);
+    });
     // Подтверждение спрашиваем ЗДЕСЬ, а не раньше: адрес апекса известен
     // только от сервера, а сборка ещё не запущена — отказ ничего не стоит.
     // Для только что созданного проекта вопрос бессмыслен: перезаписывать
@@ -670,7 +818,7 @@ export async function deployCmd(opts) {
         emit({ event: "uploaded", archive_key: session.source_archive_key });
         const started = await startWithRepeatedFailureGuard(api, session.session_id, pack.sha256, opts);
         if (!started.deploy_id) {
-            throw new LayeroError("deploy_not_started", `deploy session ended as "${started.status}"${started.error ? `: ${started.error}` : ""}`, "re-run `layero deploy`; if it repeats, check the project in the dashboard");
+            throw new LayeroError("deploy_not_started", `deploy session ended as "${started.status}"${started.error ? `: ${started.error}` : ""}`, "re-run `npx layero@latest deploy`; if it repeats, `npx layero@latest diagnose` shows the last deploy");
         }
         emit({ event: "deploy_started", deploy_id: started.deploy_id });
         const final = await streamDeployLogs(api, started.deploy_id);
@@ -680,10 +828,15 @@ export async function deployCmd(opts) {
         // более новым пушем, и совет «посмотрите логи» тут не по адресу: смотреть
         // надо на деплой-преемник, а не на этот.
         if (final.status === "cancelled") {
-            throw new LayeroError("deploy_cancelled", `deploy cancelled${final.error_message ? `: ${final.error_message}` : ""}`, "a newer deploy superseded this one — check the latest deploy in the dashboard");
+            throw new LayeroError("deploy_cancelled", `deploy cancelled${final.error_message ? `: ${final.error_message}` : ""}`, "a newer deploy superseded this one — `npx layero@latest deploys list` shows it");
         }
         if (final.status !== "ready") {
-            throw new LayeroError(`deploy_${final.status}`, `deploy failed (${final.status})${final.error_message ? `: ${final.error_message}` : ""}`, `inspect logs at ${projectUrl(cliCfg.apiUrl, project.id)}`);
+            // 🚨 Совет — КОМАНДА, а не ссылка на панель. Агенту без аккаунта
+            // (песочница `--claim`) панель недоступна вовсе, а `diagnose` работает
+            // и с токеном песочницы: причина словами плюс окрестность ошибки в логе
+            // (T-20260918-8).
+            throw new LayeroError(`deploy_${final.status}`, `deploy failed (${final.status})${final.error_message ? `: ${final.error_message}` : ""}`, `read the cause: \`npx layero@latest diagnose --deploy ${started.deploy_id}\` ` +
+                `(full build log: \`npx layero@latest logs --deploy ${started.deploy_id}\`)`);
         }
         // --promote: пин апекса на эту сборку. Промоут остаётся на клиенте
         // осознанно — сборка асинхронна, а сервер применяет промоут только
@@ -733,13 +886,30 @@ export async function deployCmd(opts) {
                 expires_at: claimable.expires_at,
             });
         }
+        else if (reusedClaim) {
+            emit({
+                event: "claimable",
+                project_id: project.id,
+                slug: project.slug,
+                url: liveUrl,
+                claim_url: reusedClaim.claim_url,
+                expires_at: reusedClaim.expires_at,
+            });
+        }
+        // `ready` — когда адрес уже отвечает сайтом, а не когда кончилась сборка.
+        // Выкатка в окружение `cli` проекта с репозиторием живой адрес не меняет —
+        // ждать там нечего.
+        const serving = promoted || !hasRepo(project) || opts.prod
+            ? await waitUntilServing(liveUrl)
+            : { serving: probe ? probe.available : true };
         emit({
             event: "ready",
             url: liveUrl,
             deploy_id: started.deploy_id,
             preview_url: probe?.preview_url ?? undefined,
             dashboard_url: dashboardUrl,
-            edge_ready: probe ? probe.available : undefined,
+            edge_ready: serving.serving,
+            ...(serving.serving ? {} : { screen: serving.screen }),
         });
     }
     finally {

package/dist/commands/diagnose.js

@@ -3,6 +3,7 @@ import { ApiClient, ApiError } from "../api.js";
 import { loadConfig } from "../config.js";
 import { loadProjectConfig } from "../project-config.js";
 import { LayeroError, detectMode, emit } from "../agent.js";
+import { claimTokenFor } from "./claim.js";
 async function resolveDeployId(api, opts, cwd) {
     if (opts.deploy) {
         // Явно указанный деплой: проект знать не обязательно, ручка работает
@@ -35,12 +36,29 @@ async function resolveDeployId(api, opts, cwd) {
     const target = deploys[0];
     return { deployId: target.id, projectId: project.id };
 }
+/**
+ * Конфиг с токеном, которым можно читать деплои этой папки.
+ *
+ * 🚨 Песочница (`deploy --claim`) — тоже вход. Её токен лежит в
+ * `~/.layero/config.json` по id проекта и прав на чтение хватает; без этой
+ * ветки агент без аккаунта получал на упавшей сборке совет «выполни
+ * `layero login`» — то есть не мог узнать причину отказа ничем, кроме панели,
+ * которая ему недоступна (T-20260918-8).
+ */
+async function configForFolder(opts, cwd) {
+    const cfg = await loadConfig();
+    if (cfg.token)
+        return cfg;
+    const linked = await loadProjectConfig(cwd);
+    const sameProject = !opts.project || opts.project === linked?.project_id || opts.project === linked?.slug;
+    const claim = sameProject ? claimTokenFor(cfg, linked?.project_id) : undefined;
+    if (claim)
+        return { ...cfg, token: claim };
+    throw new LayeroError("auth_required", "нужен вход", "выполни `layero login` или задай LAYERO_TOKEN");
+}
 export async function diagnoseCmd(opts) {
     const mode = detectMode();
-    const cfg = await loadConfig();
-    if (!cfg.token) {
-        throw new LayeroError("auth_required", "нужен вход", "выполни `layero login` или задай LAYERO_TOKEN");
-    }
+    const cfg = await configForFolder(opts, process.cwd());
     const api = new ApiClient(cfg);
     const { deployId } = await resolveDeployId(api, opts, process.cwd());
     const d = await api.getDeployDiagnosis(deployId);
@@ -79,10 +97,7 @@ export async function diagnoseCmd(opts) {
 }
 export async function logsCmd(opts) {
     const mode = detectMode();
-    const cfg = await loadConfig();
-    if (!cfg.token) {
-        throw new LayeroError("auth_required", "нужен вход", "выполни `layero login` или задай LAYERO_TOKEN");
-    }
+    const cfg = await configForFolder(opts, process.cwd());
     const api = new ApiClient(cfg);
     const { deployId } = await resolveDeployId(api, opts, process.cwd());
     if (opts.runtime) {

package/dist/commands/init.js

@@ -1,10 +1,25 @@
 import { promises as fs } from "node:fs";
 import path from "node:path";
-import { detectProject } from "../detect.js";
+import { detectProject, detectedEvent } from "../detect.js";
 import { emit } from "../agent.js";
 const AGENT_BLOCK_MARKER_START = "<!-- layero:start -->";
 const AGENT_BLOCK_MARKER_END = "<!-- layero:end -->";
-function agentDocBlock(framework) {
+/**
+ * Строка про эту папку в блоке для агентов.
+ *
+ * 🚨 Только то, в чём детект уверен. До 18.09.2026 сюда писалось имя
+ * фреймворка всегда — и `static` для монорепо, собственного скрипта сборки
+ * или фронта с бэкендом ложился в AGENTS.md как факт о проекте: следующая
+ * сессия агента читала его раньше, чем смотрела на папку (T-20260918-7).
+ */
+function folderLine(d) {
+    if (d.confident) {
+        const what = d.runtime_kind ? `${d.framework_hint}, runs as ${d.runtime_kind}` : d.framework_hint;
+        return `this project, detected by \`init\` as **${what}**`;
+    }
+    return "this project; `init` could not recognise the app here — run `npx layero@latest deploy --dry-run --json` and read `hint`";
+}
+function agentDocBlock(d) {
     // Компактный индекс, а не ссылка на навык: по evals Vercel блок в
     // AGENTS.md агент выполняет надёжнее (100 % против 79 % у навыка).
     // Полная версия — навык `layero` в LayeroInfra/layero-agents; здесь —
@@ -24,7 +39,7 @@ Docs for agents: https://docs.layero.ru/agents/
 1. **Repository connected** (GitHub, GitVerse, GitLab, GitFlic, SourceCraft) —
    push to a branch = preview, push to \`main\` = production. Connect one with
    \`npx layero@latest projects create --repo <provider>:<owner/repo>\`.
-2. **A directory with code** (this project, framework: **${framework}**) —
+2. **A directory with code** (${folderLine(d)}) —
    \`npx layero@latest deploy --json\`. The CLI packs the directory, the
    platform builds it. No git repository is needed for this path.
 3. **A site already on Layero** — \`npx layero@latest diagnose\`, \`logs\`,
@@ -34,9 +49,15 @@ Docs for agents: https://docs.layero.ru/agents/
 ### Deploy from this directory
 
 \`\`\`bash
+npx layero@latest deploy --dry-run --json   # how the platform will build it; uploads nothing
 npx layero@latest deploy --json
 \`\`\`
 
+\`--dry-run\` needs no login. If its \`confident\` is \`false\`, follow its
+\`hint\` / \`next_action\` (app in a subfolder → \`--root <dir>\`, frontend +
+backend → \`layero.json\` with both halves, custom build → \`"framework":
+"generic"\`) before the first deploy.
+
 Not logged in? The command starts the browser device flow itself and prints
 \`{"event":"auth_required","url":"…","user_code":"…"}\` — show \`url\` as a
 clickable link and keep waiting; the CLI polls every 2 s. No localhost
@@ -46,11 +67,12 @@ No account at all? \`npx layero@latest deploy --claim\` publishes to a
 temporary project for 72 hours and prints a \`claim_url\` for a human to
 take it over.
 
-Key JSON events: \`detected\` (framework), \`project_created\` /
+Key JSON events: \`detected\` (framework, \`confident\`, \`hint\`), \`project_created\` /
 \`project_linked\`, \`build_log\` (forward only lines with errors),
 \`claimable\` (\`claim_url\`, \`expires_at\`), \`ready\` — \`url\` is the live
-site: show it as-is and stop; \`dashboard_url\` is the panel, not the site.
-\`error\` — follow \`next_action\` verbatim.
+site, already answering (\`edge_ready: true\`): show it as-is and stop;
+\`dashboard_url\` is the panel, not the site. \`error\` — follow
+\`next_action\` verbatim.
 
 Exit codes: 0 ok · 2 auth (\`auth_required\`, \`auth_expired\`, \`auth_timeout\`) ·
 3 not found (\`project_unknown\`, \`project_not_found\`) · 4 invalid input
@@ -110,7 +132,7 @@ async function upsertAgentDoc(cwd, filename, content) {
     await fs.writeFile(filePath, merged, "utf-8");
     return "updated";
 }
-async function ensureProjectJson(cwd, framework, build_cmd, output_dir) {
+async function ensureProjectJson(cwd) {
     const dir = path.join(cwd, ".layero");
     const file = path.join(dir, "project.json");
     try {
@@ -121,10 +143,12 @@ async function ensureProjectJson(cwd, framework, build_cmd, output_dir) {
         // missing → create
     }
     await fs.mkdir(dir, { recursive: true });
+    // 🚨 Без framework_hint / build_cmd / output_dir. Поля в этом файле CLI
+    // читает как ВЫБОР ЧЕЛОВЕКА и отправляет в проект; положи сюда догадку
+    // детекта — и она станет «настройкой», которую никто не выбирал, а сборщик
+    // перестанет решать сам (T-20260918-7). Человек дописывает их руками, если
+    // хочет закрепить.
     const scaffold = {
-        framework_hint: framework,
-        build_cmd,
-        output_dir,
         analytics_enabled: false,
         env_vars: {},
     };
@@ -150,14 +174,8 @@ async function ensureGitignore(cwd) {
 export async function initCmd(opts) {
     const cwd = process.cwd();
     const detected = await detectProject(cwd);
-    emit({
-        event: "detected",
-        framework: detected.framework_hint,
-        build_cmd: detected.build_cmd,
-        output_dir: detected.output_dir,
-        confident: detected.confident,
-    });
-    const block = agentDocBlock(detected.framework_hint);
+    emit(detectedEvent(detected));
+    const block = agentDocBlock(detected);
     const agentDocs = [];
     if (!opts.skipAgentDocs) {
         // Touch every agent-doc convention we know about. If one already
@@ -181,11 +199,12 @@ export async function initCmd(opts) {
             agentDocs.push({ file: f, result });
         }
     }
-    const pjResult = await ensureProjectJson(cwd, detected.framework_hint, detected.build_cmd, detected.output_dir);
+    const pjResult = await ensureProjectJson(cwd);
     await ensureGitignore(cwd);
     emit({
         event: "init_done",
         framework: detected.framework_hint,
+        confident: detected.confident,
         agent_docs: agentDocs,
         project_json: pjResult,
     });

package/dist/commands/projects.js

@@ -214,7 +214,7 @@ async function finishSetup(api, project, opts) {
     emit({
         event: "setup_applied",
         project: project.slug,
-        framework: payload.framework_hint,
+        framework: payload.framework_hint ?? undefined,
         build_cmd: payload.build_cmd ?? null,
         output_dir: payload.output_dir ?? null,
         layero_found: detected.layero_found,