layero 0.11.7 → 0.11.9

package/README.md

@@ -125,11 +125,9 @@ Run `layero <cmd> --help` for full options.
 - `--claim` — deploy without an account: a temporary site for 1 hour
   plus a `claim_url` for a human to take it over. Static sites and SPAs only:
   a server app (SSR, fullstack, container) is refused before anything is
-  uploaded (`claim_static_only`, exit 4). Turns on by itself when
-  there is no token, the run is non-interactive (an agent, not CI), `--yes`
-  is passed and the project is new: no `--project`, and the folder is not
-  linked to an account project. An existing project without a token means
-  signing in (`auth_required`). With `--project` it is refused
+  uploaded (`claim_static_only`, exit 4). Only with this flag: without a
+  token and without `--claim`, `deploy` asks for a login (`auth_required`),
+  in an agent environment too. With `--project` it is refused
   (`claim_with_project`, exit 4). In CI a missing `LAYERO_TOKEN` stays an error.
 - `--org <slug>` — organization for first-time project creation.
 - `--yes` / `-y` — non-interactive mode.
@@ -155,9 +153,13 @@ closed to search engines: `robots.txt` with `Disallow: /` and
 `X-Robots-Tag: noindex, nofollow`. A human opens `claim_url`, signs in and
 takes the project into their account — the CLI cannot accept a claim by
 itself.
-The claim code is saved in `.layero/project.json`; the temporary token stays
-in `~/.layero/config.json`, so `layero deploy` in the same directory keeps
-updating the same site until the claim expires or is accepted.
+The temporary token, the claim code and the link are saved in
+`~/.layero/config.json` (readable by you only); `.layero/project.json` gets
+only the folder's link to the project, because that file goes to git and a
+claim code there would let anyone take the site. `layero deploy` in the same
+directory keeps updating the same site until the claim expires or is
+accepted. Claiming the site clears what was set up without an account —
+environment variables, deploy hooks and build settings.
 `layero claim status` shows where things stand; `layero claim accept` opens
 the page in a browser (in agent mode it prints the link).
 

package/dist/agent.js

@@ -342,8 +342,8 @@ function renderHuman(event) {
             process.stdout.write(`✓ Проект ${event.slug} удалён (очистка ресурсов идёт в фоне)\n`);
             break;
         case "claimable":
-            process.stdout.write(`→ Временный проект ${event.slug}: ${event.url}\n`);
-            process.stdout.write(`  Сайт живёт до ${event.expires_at} (час). Забрать в аккаунт: ${event.claim_url}\n`);
+            process.stdout.write(`→ Временный сайт ${event.slug}: ${event.preview_url ?? event.url}\n`);
+            process.stdout.write(`  Живёт до ${event.expires_at} (час). Забрать в аккаунт: ${event.claim_url}\n`);
             break;
         case "claim_status":
             process.stdout.write(`Код ${event.code}: ${event.status}${event.claimed ? " (забран)" : ""}` +

package/dist/bin/layero.js

@@ -456,8 +456,7 @@ async function main() {
         .option("--claim", "deploy without an account: a temporary site for 1 hour plus a claim_url for a human to take it over. " +
         "Static sites and SPAs only — a server app (SSR, fullstack, container) is refused (claim_static_only, exit 4). " +
         "The address is random and closed to search engines. " +
-        "Turns on by itself when there is no token, the run is non-interactive (agent, not CI), --yes is passed " +
-        "and the project is new (no --project, folder not linked to an account project). " +
+        "Only with this flag: without a token and without --claim, deploy asks for a login. " +
         "Refused together with --project (claim_with_project, exit 4).")
         .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.")
         // Осознанное подтверждение выкатки, когда предыдущие сборки подряд падают

package/dist/commands/claim.js

@@ -1,7 +1,7 @@
 import open from "open";
 import { ApiClient, ApiError } from "../api.js";
-import { loadConfig, saveConfig } from "../config.js";
-import { loadProjectConfig, persistProjectLinking } from "../project-config.js";
+import { forgetSandbox, loadConfig, saveClaim, saveConfig } from "../config.js";
+import { loadProjectConfig, persistProjectLinking, unlinkProject } from "../project-config.js";
 import { LayeroError, detectMode, emit } from "../agent.js";
 import { dashboardOrigin } from "../urls.js";
 /**
@@ -32,9 +32,10 @@ export function claimCodeOf(created) {
     throw new LayeroError("claimable_unavailable", "платформа не вернула код заявки", "повторите позже; если повторяется — сообщите на https://docs.layero.ru/contacts/");
 }
 /**
- * Создать claimable-проект и запомнить его: токен — в `~/.layero/config.json`
- * (по проекту), код и ссылку — в `.layero/project.json`. Возвращает конфиг
- * с токеном заявки, которым идёт деплой.
+ * Создать claimable-проект и запомнить его: токен, код и ссылку — в
+ * `~/.layero/config.json` (по проекту, файл 0600); в `.layero/project.json` —
+ * только привязка папки. Возвращает конфиг с токеном заявки, которым идёт
+ * деплой.
  */
 export async function createClaimable(cfg, cwd, input) {
     const api = new ApiClient(cfg);
@@ -53,23 +54,84 @@ export async function createClaimable(cfg, cwd, input) {
         throw err;
     }
     const code = claimCodeOf(created);
+    const claim = { code, claim_url: created.claim_url, expires_at: created.expires_at };
     const next = {
         ...cfg,
         token: created.token,
         claim_tokens: { ...(cfg.claim_tokens ?? {}), [created.project_id]: created.token },
+        claims: { ...(cfg.claims ?? {}), [created.project_id]: claim },
     };
-    // В файл — только карту токенов заявок, не сам токен как «вход»: иначе
-    // следующий `layero whoami` считал бы временный токен аккаунтом.
-    await saveConfig({ ...cfg, claim_tokens: next.claim_tokens });
+    // В файл — карты заявок, не сам токен как «вход»: иначе следующий
+    // `layero whoami` считал бы временный токен аккаунтом.
+    await saveConfig({ ...cfg, claim_tokens: next.claim_tokens, claims: next.claims });
+    // 🚨 Код забора в project.json НЕ пишется (T-20260921): файл уходит в git.
     await persistProjectLinking(cwd, {
         project_id: created.project_id,
         slug: created.slug,
         organization_slug: created.organization,
         apex_hostname: created.url ? new URL(created.url).hostname : `${created.slug}.layero.app`,
-        claim: { code, claim_url: created.claim_url, expires_at: created.expires_at },
     });
     return { cfg: next, created, code };
 }
+/**
+ * Жива ли песочница папки, прежде чем выкатывать в неё её токеном (T-20260919-3).
+ *
+ * Токен песочницы умирает в двух случаях: сайт забрали в аккаунт (токен
+ * отозван при заборе) или вышел срок — час, после чего уборка удаляет проект
+ * и держателя. Раньше агент узнавал об этом сырым 401 посреди выкатки и не
+ * знал, что делать дальше. Публичный статус по коду заявки отвечает до
+ * упаковки: `claimed` → `sandbox_claimed` (войти тем аккаунтом, привязка
+ * остаётся — проект тот же), `expired` или кода больше нет → `sandbox_expired`
+ * (мёртвые токен, заявка и привязка убираются, `--claim` заведёт новую).
+ * Сеть или платформа не ответили — не отказываем: решит сама выкатка.
+ */
+export async function assertSandboxAlive(cfg, cwd, linked) {
+    const claim = claimFor(cfg, linked);
+    if (!claim?.code || !linked?.project_id)
+        return;
+    let status;
+    try {
+        status = (await new ApiClient({ apiUrl: cfg.apiUrl }).getClaimStatus(claim.code)).status;
+    }
+    catch (err) {
+        if (err instanceof ApiError && (err.status === 404 || err.status === 410))
+            status = "expired";
+        else
+            return;
+    }
+    const site = linked.slug ? ` (${linked.slug})` : "";
+    if (status === "claimed") {
+        await forgetSandbox(linked.project_id);
+        throw new LayeroError("sandbox_claimed", `сайт этой папки${site} забрали в аккаунт — токен песочницы больше не действует`, "the person took the site into their account: sign in with that account " +
+            "(`npx layero@latest login`) and run the same deploy — the folder stays linked to the project");
+    }
+    if (status === "expired") {
+        await forgetSandbox(linked.project_id);
+        await unlinkProject(cwd);
+        throw new LayeroError("sandbox_expired", `песочница этой папки${site} истекла и удалена`, "a new site without an account: `npx layero@latest deploy --claim` (static sites and SPAs, 1 hour); " +
+            "to keep a site, sign in and deploy into the account");
+    }
+}
+/**
+ * Код забора из `.layero/project.json` старого CLI (до 0.11.8) — в конфиг.
+ * Файл папки после этого перепишет `persistProjectLinking` уже без кода.
+ */
+export async function keepLegacyClaim(cfg, linked) {
+    if (!linked?.project_id || !linked.claim?.code)
+        return;
+    if (cfg.claims?.[linked.project_id])
+        return;
+    await saveClaim(linked.project_id, linked.claim);
+}
+/**
+ * Заявка песочницы для проекта папки: из `~/.layero/config.json`, а у папок,
+ * выложенных CLI до 0.11.8, — из старого поля `claim` в `.layero/project.json`.
+ */
+export function claimFor(cfg, linked) {
+    if (!linked?.project_id)
+        return undefined;
+    return cfg.claims?.[linked.project_id] ?? linked.claim ?? undefined;
+}
 /** Токен заявки для проекта из `.layero/project.json`, если он есть. */
 export function claimTokenFor(cfg, projectId) {
     if (!projectId)
@@ -100,19 +162,19 @@ export async function configForFolder(opts, cwd) {
 function claimUrlFor(cfg, code) {
     return `${dashboardOrigin(cfg.apiUrl)}/claim?code=${encodeURIComponent(code)}`;
 }
-async function resolveCode(cwd, explicit) {
+async function resolveCode(cfg, cwd, explicit) {
     if (explicit)
         return { code: explicit.trim(), claim_url: null };
-    const linked = await loadProjectConfig(cwd);
-    if (linked?.claim?.code)
-        return { code: linked.claim.code, claim_url: linked.claim.claim_url };
+    const claim = claimFor(cfg, await loadProjectConfig(cwd));
+    if (claim?.code)
+        return { code: claim.code, claim_url: claim.claim_url };
     throw new LayeroError("claim_unknown", "в этой папке нет claimable-проекта", "передайте код: `layero claim status <code>` — или создайте проект без аккаунта: `layero deploy --claim`");
 }
 /** `layero claim status [code]` — что с заявкой: жива, забрана, истекла. */
 export async function claimStatusCmd(code, opts) {
     const cwd = process.cwd();
     const cfg = await loadConfig();
-    const ref = await resolveCode(cwd, code);
+    const ref = await resolveCode(cfg, cwd, code);
     // Без токена намеренно: статус заявки — публичный по коду, как и сама ссылка.
     const api = new ApiClient({ apiUrl: cfg.apiUrl });
     let status;
@@ -145,7 +207,7 @@ export async function claimStatusCmd(code, opts) {
 export async function claimAcceptCmd(code, opts) {
     const cwd = process.cwd();
     const cfg = await loadConfig();
-    const ref = await resolveCode(cwd, code);
+    const ref = await resolveCode(cfg, cwd, code);
     const claimUrl = ref.claim_url ?? claimUrlFor(cfg, ref.code);
     const mode = detectMode();
     let opened = false;

package/dist/commands/deploy.js

@@ -13,7 +13,7 @@ import { detectProject, detectedEvent } from "../detect.js";
 import { runDeviceLogin } from "../auth.js";
 import { LayeroError, detectMode, emit, isCiEnv } from "../agent.js";
 import { ensureUsername } from "../username.js";
-import { claimTokenFor, createClaimable } from "./claim.js";
+import { assertSandboxAlive, claimFor, claimTokenFor, createClaimable, keepLegacyClaim } from "./claim.js";
 const VALID_TYPES = new Set([
     "vite",
     "next",
@@ -209,6 +209,13 @@ async function assertSandboxServesFiles(cwd, opts, existing, detectFolder) {
         return;
     throw new LayeroError("claim_static_only", `деплой без аккаунта (--claim) выкладывает только статику и SPA, а эта папка — серверное приложение (${kind})`, "sign in and deploy from the account: `npx layero@latest login`, then run the same deploy without --claim");
 }
+/** Обёртка временного сайта по его адресу: `<панель>/preview/<метка>`.
+ *  Считается здесь для повторной выкатки — платформа отдаёт поле только при
+ *  создании песочницы. */
+function sandboxPreviewUrl(siteUrl) {
+    const label = new URL(siteUrl).hostname.split(".")[0];
+    return `https://app.layero.ru/preview/${label}`;
+}
 /**
  * 🚨 ДЕТЕКТ — ОДИН НА ВЫКАТКУ. Гейт core «входов анализа не становится
  * больше» считает запуски детекта в этом файле: каждый лишний — ещё один
@@ -560,7 +567,7 @@ export async function deployCmd(opts) {
     const projectIsLinkedOne = !opts.project ||
         (existing?.project_id !== undefined &&
             (opts.project === existing.project_id || opts.project === existing.slug));
-    const linkedIsClaimable = Boolean(existing?.project_id && existing.claim);
+    const linkedIsClaimable = Boolean(existing?.project_id && (claimFor(cliCfg, existing) || claimTokenFor(cliCfg, existing.project_id)));
     const boundToAccountProject = opts.project
         ? !(projectIsLinkedOne && linkedIsClaimable)
         : Boolean(existing?.project_id) && !linkedIsClaimable;
@@ -572,18 +579,20 @@ export async function deployCmd(opts) {
             ? claimTokenFor(cliCfg, existing?.project_id)
             : undefined;
         if (reuse) {
+            await assertSandboxAlive(cliCfg, cwd, existing);
             await assertSandboxServesFiles(cwd, opts, existing, detectFolder);
             cliCfg = { ...cliCfg, token: reuse };
             // Повторная выкатка песочницы: ссылка «забрать» нужна агенту и здесь —
             // без неё он искал её в `.layero/project.json` (симуляция 18.09.2026).
-            if (existing?.claim)
-                reusedClaim = existing.claim;
+            reusedClaim = claimFor(cliCfg, existing) ?? null;
         }
         else if (
-        // Явный `--claim` — всегда новая песочница (с `--project` он отклонён
-        // выше). Сам режим включается только для нового проекта.
-        opts.claim ||
-            (!boundToAccountProject && !mode.interactive && !isCiEnv() && opts.yes)) {
+        // 🚨 ТОЛЬКО ЯВНЫЙ `--claim` (T-20260921). До 0.11.8 режим включался сам —
+        // нет токена, агентская среда, `--yes` — и агент молча публиковал папку
+        // в открытый интернет: человек не решал публиковать и не принимал
+        // условий. Теперь без флага — обычный вход (`auth_required`). С
+        // `--project` флаг отклонён выше: песочница — только новый проект.
+        opts.claim) {
             // 🚨 CI СЮДА НЕ ПОПАДАЕТ НАМЕРЕННО. Раннер без LAYERO_TOKEN — это
             // забытый секрет, и правильный ответ ему — отказ, а не сайт на
             // временном адресе, который через час исчезнет вместе с «зелёным»
@@ -595,6 +604,9 @@ export async function deployCmd(opts) {
             cliCfg = r.cfg;
             claimable = {
                 claim_url: r.created.claim_url,
+                // Обёртка панели — ссылка «для людей»: голый адрес песочницы браузеру
+                // отвечает переходом на неё. Старая платформа поля не отдаёт.
+                preview_url: r.created.preview_url ?? null,
                 expires_at: r.created.expires_at,
                 project_id: r.created.project_id,
                 slug: r.created.slug,
@@ -817,6 +829,9 @@ export async function deployCmd(opts) {
     }
     // Только связка папки с проектом. Фреймворк сюда больше не пишется: поле
     // этого файла CLI читает как выбор человека (см. `resolveSetupConfig`).
+    // Код забора старого CLI сначала уезжает в конфиг, потом файл
+    // переписывается уже без него (T-20260921).
+    await keepLegacyClaim(cliCfg, existing);
     await persistProjectLinking(cwd, {
         project_id: project.id,
         slug: project.slug,
@@ -926,13 +941,16 @@ export async function deployCmd(opts) {
             emit({ event: "preview_evicted", evicted });
         }
         // Claimable: ссылка «забрать» — ДО `ready`, потому что после `ready`
-        // агент не читает, а без этой ссылки сайт исчезнет через 72 часа.
+        // агент не читает, а без этой ссылки сайт исчезнет через час.
+        // `preview_url` — обёртка панели: пока сайт временный, человеку
+        // открывается только она; `url` остаётся для проверок и агентов.
         if (claimable) {
             emit({
                 event: "claimable",
                 project_id: claimable.project_id,
                 slug: claimable.slug,
                 url: liveUrl,
+                preview_url: claimable.preview_url ?? sandboxPreviewUrl(liveUrl),
                 claim_url: claimable.claim_url,
                 expires_at: claimable.expires_at,
             });
@@ -943,6 +961,7 @@ export async function deployCmd(opts) {
                 project_id: project.id,
                 slug: project.slug,
                 url: liveUrl,
+                preview_url: sandboxPreviewUrl(liveUrl),
                 claim_url: reusedClaim.claim_url,
                 expires_at: reusedClaim.expires_at,
             });

package/dist/config.js

@@ -27,6 +27,7 @@ export async function loadConfig() {
             // выводе врала бы. Кто мы — узнаем у API.
             user: ENV_TOKEN ? undefined : parsed.user,
             claim_tokens: parsed.claim_tokens,
+            claims: parsed.claims,
         };
     }
     catch (err) {
@@ -47,6 +48,57 @@ export async function saveConfig(cfg) {
         await fs.chmod(CONFIG_FILE, 0o600);
     }
 }
+/**
+ * Записать заявку песочницы в файл конфига, не трогая остального.
+ *
+ * Читает и пишет САМ файл, а не результат `loadConfig`: тот подставляет
+ * `LAYERO_TOKEN` из окружения, и запись через него унесла бы токен CI в
+ * файл на диске.
+ */
+export async function saveClaim(projectId, claim) {
+    let raw = {};
+    try {
+        raw = JSON.parse(await fs.readFile(CONFIG_FILE, "utf-8"));
+    }
+    catch (err) {
+        if (err?.code !== "ENOENT")
+            throw err;
+    }
+    const claims = { ...(raw.claims ?? {}), [projectId]: claim };
+    await ensureDir();
+    await fs.writeFile(CONFIG_FILE, JSON.stringify({ ...raw, claims }, null, 2), {
+        encoding: "utf-8",
+        mode: 0o600,
+    });
+    if (process.platform !== "win32")
+        await fs.chmod(CONFIG_FILE, 0o600);
+}
+/**
+ * Забыть песочницу: её токен и заявку (T-20260919-3). Зовётся, когда
+ * песочницы больше нет или её забрали, — мёртвый токен иначе подхватывала бы
+ * каждая следующая выкатка из этой папки. Пишет сам файл (см. `saveClaim`).
+ */
+export async function forgetSandbox(projectId) {
+    let raw;
+    try {
+        raw = JSON.parse(await fs.readFile(CONFIG_FILE, "utf-8"));
+    }
+    catch (err) {
+        if (err?.code === "ENOENT")
+            return;
+        throw err;
+    }
+    const tokens = { ...(raw.claim_tokens ?? {}) };
+    const claims = { ...(raw.claims ?? {}) };
+    delete tokens[projectId];
+    delete claims[projectId];
+    await fs.writeFile(CONFIG_FILE, JSON.stringify({ ...raw, claim_tokens: tokens, claims }, null, 2), {
+        encoding: "utf-8",
+        mode: 0o600,
+    });
+    if (process.platform !== "win32")
+        await fs.chmod(CONFIG_FILE, 0o600);
+}
 export async function clearConfig() {
     try {
         await fs.unlink(CONFIG_FILE);

package/dist/exit-codes.js

@@ -19,8 +19,9 @@
  * `check-error-codes.py`), и класс выхода становится его частью. Новый код,
  * не попавший ни в один список, даёт 1 — честно «прочее», а не наугад.
  */
-const AUTH = new Set(["auth_required", "auth_expired", "auth_timeout"]);
+const AUTH = new Set(["auth_required", "auth_expired", "auth_timeout", "sandbox_claimed"]);
 const NOT_FOUND = new Set([
+    "sandbox_expired",
     "project_unknown",
     "project_not_found",
     "org_unknown",

package/dist/project-config.js

@@ -67,8 +67,9 @@ export async function persistProjectLinking(cwd, linking, fallbackHint) {
     };
     if (linking.api_url !== undefined)
         merged.api_url = linking.api_url;
-    if (linking.claim !== undefined)
-        merged.claim = linking.claim;
+    // Код забора от CLI до 0.11.8 — вон из файла, который коммитят
+    // (T-20260921). Живую заявку вызывающий перед этим переносит в конфиг.
+    delete merged.claim;
     // Only seed framework_hint if the user hasn't set one yet — once it's in
     // the file (manually or from a prior --type), leave it alone.
     if (fallbackHint != null &&
@@ -79,3 +80,30 @@ export async function persistProjectLinking(cwd, linking, fallbackHint) {
     await fs.writeFile(file, JSON.stringify(merged, null, 2), "utf-8");
     return merged;
 }
+/**
+ * Отвязать папку от проекта, сохранив поля, которые человек вписал сам.
+ *
+ * Зовётся, когда проекта больше нет — песочница истекла и удалена
+ * (T-20260919-3): мёртвая привязка иначе уводила бы каждую следующую выкатку
+ * в несуществующий проект. Пустой после этого файл удаляется.
+ */
+export async function unlinkProject(cwd) {
+    const file = projectConfigPath(cwd);
+    let raw;
+    try {
+        raw = JSON.parse(await fs.readFile(file, "utf-8"));
+    }
+    catch (err) {
+        if (err?.code === "ENOENT")
+            return;
+        throw err;
+    }
+    for (const key of ["project_id", "slug", "organization_slug", "owner_slug", "apex_hostname", "api_url", "claim"]) {
+        delete raw[key];
+    }
+    if (Object.keys(raw).length === 0) {
+        await fs.unlink(file);
+        return;
+    }
+    await fs.writeFile(file, JSON.stringify(raw, null, 2), "utf-8");
+}

package/package.json

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