layero 0.9.5 → 0.10.0

package/dist/commands/deploy.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import readline from "node:readline/promises";
 import chalk from "chalk";
 import { ApiClient, ApiError, uploadArchive, } from "../api.js";
+import { looksLikeId } from "../project-ref.js";
 import { dashboardOrigin } from "../urls.js";
 import { loadConfig } from "../config.js";
 import { loadProjectConfig, persistProjectLinking, } from "../project-config.js";
@@ -12,7 +13,7 @@ import { detectProject } from "../detect.js";
 import { runDeviceLogin } from "../auth.js";
 import { LayeroError, detectMode, emit, isCiEnv } from "../agent.js";
 import { ensureUsername } from "../username.js";
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+import { claimTokenFor, createClaimable } from "./claim.js";
 const VALID_TYPES = new Set([
     "vite",
     "next",
@@ -363,21 +364,78 @@ export async function deployCmd(opts) {
             `runtime kinds: ${[...new Set(Object.values(RUNTIME_TYPES))].join(", ")} ` +
             `(aliases: ${Object.keys(RUNTIME_TYPES).join(", ")})`);
     }
+    const cwd = process.cwd();
+    let existing = await loadProjectConfig(cwd);
     let cliCfg = await loadConfig();
+    // Claimable-проект этого запуска (этап 13): событие `claimable` уходит
+    // перед `ready`, когда адрес сайта уже известен.
+    let claimable = null;
     if (!cliCfg.token) {
-        // In CI nobody can open a browser, so the device flow can only end one
-        // way: fifteen minutes of a hung job and then `auth_expired`. Fail
-        // immediately instead, and say what to do — burning a quarter of an hour
-        // of someone's runner to reach a foregone conclusion is not acceptable.
-        if (isCiEnv()) {
+        // Папка уже привязана к claimable-проекту — деплоим его же токеном,
+        // пока заявка жива. Заявка забрана или истекла — платформа ответит 401,
+        // и это станет `auth_expired`: честнее, чем молча завести ещё один.
+        const reuse = claimTokenFor(cliCfg, existing?.project_id);
+        if (reuse) {
+            cliCfg = { ...cliCfg, token: reuse };
+        }
+        else if (opts.claim || (!mode.interactive && !isCiEnv() && opts.yes)) {
+            // 🚨 CI СЮДА НЕ ПОПАДАЕТ НАМЕРЕННО. Раннер без LAYERO_TOKEN — это
+            // забытый секрет, и правильный ответ ему — отказ, а не сайт на
+            // временном адресе, который через 72 часа исчезнет вместе с
+            // «зелёным» прогоном. Явный `--claim` в CI работает.
+            const r = await createClaimable(cliCfg, cwd, {
+                name: opts.name ?? path.basename(cwd),
+            });
+            cliCfg = r.cfg;
+            claimable = {
+                claim_url: r.created.claim_url,
+                expires_at: r.created.expires_at,
+                project_id: r.created.project_id,
+                slug: r.created.slug,
+            };
+            existing = await loadProjectConfig(cwd);
+        }
+        else if (isCiEnv()) {
+            // In CI nobody can open a browser, so the device flow can only end one
+            // way: fifteen minutes of a hung job and then `auth_expired`. Fail
+            // immediately instead, and say what to do — burning a quarter of an hour
+            // of someone's runner to reach a foregone conclusion is not acceptable.
             throw new LayeroError("auth_required", "No credentials in CI. Create a token at https://app.layero.ru/settings/cli " +
                 "and pass it as the LAYERO_TOKEN environment variable.", "set_layero_token");
         }
-        cliCfg = await runDeviceLogin(cliCfg);
+        else {
+            cliCfg = await runDeviceLogin(cliCfg);
+        }
+    }
+    else if (opts.claim) {
+        throw new LayeroError("bad_format", "--claim — деплой без аккаунта, а вход уже выполнен", "уберите --claim: проект создастся в вашем аккаунте; либо `layero logout` перед `--claim`");
     }
     const api = new ApiClient(cliCfg);
-    const cwd = process.cwd();
-    const existing = await loadProjectConfig(cwd);
+    // 🚨 `--branch` У АРХИВНОЙ ЗАГРУЗКИ НЕ РАБОТАЕТ, И МОЛЧАТЬ ОБ ЭТОМ НЕЛЬЗЯ.
+    // Платформа кладёт каждый архив в зарезервированное окружение `cli`, что
+    // бы ни передали (`projects.py`, «Branch targeting»). До 0.10.0 флаг
+    // принимался и игнорировался: агент читал в справке «deploy to a specific
+    // branch's environment», делал `--branch=probe` и заменял живой сайт,
+    // считая, что выложил превью. Теперь — отказ до упаковки, с разной
+    // подсказкой для проекта без репозитория и с ним.
+    if (opts.branch) {
+        let linked = null;
+        try {
+            if (opts.project)
+                linked = await api.resolveProject(opts.project);
+            else if (existing?.project_id)
+                linked = await api.getProject(existing.project_id);
+        }
+        catch {
+            linked = null;
+        }
+        const repo = linked?.repo_full_name && linked.repo_status !== "disconnected" ? linked.repo_full_name : null;
+        throw new LayeroError("branch_unsupported", repo
+            ? `--branch ${opts.branch}: архивная загрузка не попадает в ветку — платформа кладёт её в окружение «cli»`
+            : `--branch ${opts.branch}: у проекта нет подключённого репозитория, а превью-ветки есть только у проектов с репозиторием`, repo
+            ? `изолированное превью — push в ветку «${opts.branch}» репозитория ${repo}; \`layero deploy\` без --branch обновит окружение «cli»`
+            : "превью-ветки есть только у проектов с репозиторием: подключите его — `layero projects create --repo <provider>:<owner/repo>` — и пушьте в ветку; папку без репозитория выкладывает `layero deploy` без --branch");
+    }
     // --- Всё, что требует файловой системы, делаем сами. Остальное — сервер.
     const prebuiltDir = await resolvePrebuiltDir(cwd, opts.prebuilt);
     const setup = prebuiltDir
@@ -436,7 +494,7 @@ export async function deployCmd(opts) {
         // Опечатка в слаге при этом обязана дать 404, а не завести лишний
         // проект с похожим именем: `create_if_missing: false`.
         ...(opts.project
-            ? UUID_RE.test(opts.project)
+            ? looksLikeId(opts.project)
                 ? { project_id: opts.project }
                 : { name: opts.project, create_if_missing: false }
             : existing?.project_id
@@ -638,6 +696,18 @@ export async function deployCmd(opts) {
         if (evicted.length > 0) {
             emit({ event: "preview_evicted", evicted });
         }
+        // Claimable: ссылка «забрать» — ДО `ready`, потому что после `ready`
+        // агент не читает, а без этой ссылки сайт исчезнет через 72 часа.
+        if (claimable) {
+            emit({
+                event: "claimable",
+                project_id: claimable.project_id,
+                slug: claimable.slug,
+                url: liveUrl,
+                claim_url: claimable.claim_url,
+                expires_at: claimable.expires_at,
+            });
+        }
         emit({
             event: "ready",
             url: liveUrl,

package/dist/commands/envs.js

@@ -0,0 +1,44 @@
+import { ApiClient } from "../api.js";
+import { loadConfig } from "../config.js";
+import { loadProjectConfig } from "../project-config.js";
+import { LayeroError, emit } from "../agent.js";
+/**
+ * `layero envs list [--project]` — окружения проекта с адресами.
+ *
+ * Отдельной ручки «environments» в API нет: окружение и ветка — одна
+ * сущность (`environments` в базе, `/projects/{id}/branches` наружу), и
+ * список приходит оттуда. У CLI-проекта это одно окружение `cli`; у проекта
+ * с репозиторием — ветка на окружение. Архивные и снятые с раздачи в список
+ * не входят — так же, как в панели.
+ */
+export async function envsListCmd(opts) {
+    const cfg = await loadConfig();
+    if (!cfg.token) {
+        throw new LayeroError("auth_required", "вход не выполнен", "выполните `layero login` или задайте LAYERO_TOKEN");
+    }
+    const api = new ApiClient(cfg);
+    let ref = opts.project;
+    if (!ref) {
+        const linked = await loadProjectConfig(process.cwd());
+        ref = linked?.project_id;
+    }
+    if (!ref) {
+        throw new LayeroError("project_unknown", "в этой папке нет привязанного проекта", "запустите из папки проекта или передайте --project <id|slug>");
+    }
+    const project = await api.resolveProject(ref);
+    const branches = await api.listBranches(project.id);
+    const productionBranch = project.production_branch_name ?? project.default_branch;
+    emit({
+        event: "environments",
+        project: project.slug,
+        environments: branches.map((b) => ({
+            id: b.id,
+            branch: b.branch_name,
+            url: b.preview_url,
+            hostname: b.hostname,
+            active_deploy_id: b.active_deploy_id,
+            active_deploy_at: b.active_deploy_at ?? null,
+            production: b.branch_name === productionBranch,
+        })),
+    });
+}

package/dist/commands/hooks.js

@@ -1,23 +1,22 @@
-import chalk from "chalk";
 import { ApiClient, ApiError } from "../api.js";
 import { loadConfig } from "../config.js";
 import { loadProjectConfig } from "../project-config.js";
+import { LayeroError, emit } from "../agent.js";
 async function resolveProjectId(opts) {
     if (opts.project) {
-        // Accepts an id directly; UUID format check is server-side.
+        // Принимает id напрямую; форма UUID проверяется на сервере.
         return opts.project;
     }
     const linked = await loadProjectConfig(process.cwd());
     if (linked?.project_id) {
         return linked.project_id;
     }
-    throw new Error("no project linked in cwd — pass --project <id> or run `layero deploy` "
-        + "from a project directory once to link it.");
+    throw new LayeroError("project_unknown", "в этой папке нет привязанного проекта", "передайте --project <id> или запустите `layero deploy` из папки проекта, чтобы привязать её");
 }
 async function makeClient() {
     const cfg = await loadConfig();
     if (!cfg.token) {
-        throw new Error("not logged in. run `layero login` first.");
+        throw new LayeroError("auth_required", "вход не выполнен", "выполните `layero login` или задайте LAYERO_TOKEN");
     }
     return new ApiClient(cfg);
 }
@@ -25,24 +24,22 @@ export async function hooksListCmd(opts) {
     const api = await makeClient();
     const projectId = await resolveProjectId(opts);
     const hooks = await api.listDeployHooks(projectId);
-    if (hooks.length === 0) {
-        console.log("no deploy hooks yet — `layero hooks create <name>` to add one.");
-        return;
-    }
-    for (const h of hooks) {
-        const targetTag = h.target === "production" ? chalk.red("[prod]") : chalk.cyan("[preview]");
-        const branchTag = h.branch ? chalk.dim(`branch=${h.branch}`) : chalk.dim("branch=default");
-        const last = h.last_triggered_at
-            ? `fired ${new Date(h.last_triggered_at).toISOString()}`
-            : "never fired";
-        console.log(`${targetTag} ${chalk.bold(h.name)}  ${branchTag}  ${chalk.dim("(" + last + ")")}`);
-        console.log(`        ${chalk.dim(h.id)}`);
-        console.log(`        ${h.url}`);
-    }
+    emit({
+        event: "hooks",
+        project: projectId,
+        hooks: hooks.map((h) => ({
+            id: h.id,
+            name: h.name,
+            branch: h.branch,
+            target: h.target,
+            url: h.url,
+            last_triggered_at: h.last_triggered_at,
+        })),
+    });
 }
 export async function hooksCreateCmd(name, opts) {
     if (!name || !name.trim()) {
-        throw new Error("name is required: `layero hooks create <name>`");
+        throw new LayeroError("bad_format", "нужно имя хука", "`layero hooks create <имя>`");
     }
     const api = await makeClient();
     const projectId = await resolveProjectId(opts);
@@ -51,17 +48,19 @@ export async function hooksCreateCmd(name, opts) {
         branch: opts.branch ?? null,
         target: opts.prod ? "production" : "preview",
     });
-    const targetTag = hook.target === "production" ? chalk.red("[prod]") : chalk.cyan("[preview]");
-    console.log(`${chalk.green("✓")} created ${targetTag} ${chalk.bold(hook.name)}`);
-    console.log(`  ${chalk.dim(hook.id)}`);
-    console.log(`  ${chalk.bold(hook.url)}`);
-    console.log(chalk.dim("\n  Paste this URL into your CMS / cron / external CI as a POST webhook. "
-        + "Anyone with the URL can fire a build — treat it like a secret. "
-        + "Rotate by deleting and creating a new one."));
+    emit({
+        event: "hook_created",
+        project: projectId,
+        id: hook.id,
+        name: hook.name,
+        branch: hook.branch,
+        target: hook.target,
+        url: hook.url,
+    });
 }
 export async function hooksDeleteCmd(hookId, opts) {
     if (!hookId) {
-        throw new Error("hook id is required: `layero hooks delete <id>`");
+        throw new LayeroError("bad_format", "нужен id хука", "`layero hooks delete <id>`");
     }
     const api = await makeClient();
     const projectId = await resolveProjectId(opts);
@@ -70,11 +69,9 @@ export async function hooksDeleteCmd(hookId, opts) {
     }
     catch (err) {
         if (err instanceof ApiError && err.status === 404) {
-            console.error(chalk.yellow(`no hook ${hookId} on this project (already deleted?)`));
-            process.exitCode = 1;
-            return;
+            throw new LayeroError("hook_not_found", `у проекта нет хука ${hookId} (уже удалён?)`, "`layero hooks list`");
         }
         throw err;
     }
-    console.log(`${chalk.green("✓")} hook ${chalk.dim(hookId)} revoked`);
+    emit({ event: "hook_deleted", project: projectId, id: hookId });
 }

package/dist/commands/init.js

@@ -1,96 +1,73 @@
 import { promises as fs } from "node:fs";
 import path from "node:path";
-import chalk from "chalk";
 import { detectProject } from "../detect.js";
-import { emit, detectMode } from "../agent.js";
+import { emit } from "../agent.js";
 const AGENT_BLOCK_MARKER_START = "<!-- layero:start -->";
 const AGENT_BLOCK_MARKER_END = "<!-- layero:end -->";
 function agentDocBlock(framework) {
+    // Компактный индекс, а не ссылка на навык: по evals Vercel блок в
+    // AGENTS.md агент выполняет надёжнее (100 % против 79 % у навыка).
+    // Полная версия — навык `layero` в LayeroInfra/layero-agents; здесь —
+    // то, без чего первый деплой не случится. Коды ошибок сверяет
+    // `check-error-codes.py`: не перечислять здесь то, чего CLI не выдаёт.
     return `${AGENT_BLOCK_MARKER_START}
-## Deploying with Layero
+## Layero
 
-This project deploys to Layero (https://layero.ru). To ship local changes:
+This project deploys to Layero (https://layero.ru) — hosting with build servers
+in Russia. Full agent skill: https://github.com/LayeroInfra/layero-agents
+(\`npx skills add LayeroInfra/layero-agents\`, Claude Code:
+\`claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero\`).
+Docs for agents: https://docs.layero.ru/agents/
 
-\`\`\`bash
-npx layero@latest deploy
-\`\`\`
-
-Detected framework: **${framework}**. No git repository or GitHub connection
-is required — Layero packs and uploads the local directory directly.
-
-### First-time auth (one-click device flow)
-
-If you're not logged in yet, \`npx layero@latest deploy\` (or \`… login\`)
-starts the browser device-flow automatically and emits a JSON line:
-
-\`\`\`json
-{"event":"auth_required","url":"https://app.layero.ru/cli?code=ABCD-1234","user_code":"ABCD-1234"}
-\`\`\`
-
-Render the \`url\` as a clickable link in chat. The user opens it, signs in
-(by an emailed code or with Yandex ID — Layero creates the account on first sign-in),
-clicks "Разрешить доступ", and the CLI's poll loop picks up the token within
-2 seconds. No localhost server is involved — the browser can be on a
-different machine than the CLI.
-
-### JSON-lines events
-
-When run inside an agent (\`CURSOR_AGENT\`, \`CLAUDECODE\`, or any non-TTY
-stdout), the CLI auto-switches to JSON-lines. Key events to watch:
-
-| event | meaning |
-|---|---|
-| \`auth_required\` | render \`url\` as a link, keep waiting |
-| \`detected\` | framework auto-detection result |
-| \`project_created\` / \`project_linked\` | project bound for this directory |
-| \`build_log\` | forward only if it contains errors |
-| \`ready\` | \`url\` = live public site (show to user, stop). \`dashboard_url\` = management page. |
-| \`error\` | follow \`next_action\` field verbatim |
-
-Common error codes and remediation:
-
-- \`auth_required\` → run \`npx layero@latest login\`, or set \`LAYERO_TOKEN\`
-- \`auth_expired\` / \`auth_timeout\` → user did not approve in time, re-run login
-- \`project_unknown\` → run from the project directory, or pass \`--project\`
-- \`invalid_type\` → drop \`--type\`, rely on auto-detect
-- \`cli_deploys_disabled\` → user must enable CLI deploys in project settings
-- \`deploy_failed\` → check the dashboard URL in the message
-- \`internal\` → unexpected CLI error; re-run with \`--debug\`
+### Three paths — pick by situation
 
-There is no \`not_logged_in\`, \`deploy_error\` or \`deploy_timed_out\` — do not
-branch on codes that are not listed here.
+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}**) —
+   \`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\`,
+   \`rollback\`, \`domains\`, \`env\`, \`envs list\`, or the MCP server
+   \`https://mcp.layero.ru/mcp\`.
 
-### Re-deploys and production
-
-A plain \`npx layero deploy\` of a CLI project **publishes to the apex**
-\`https://<project>.layero.app\` — direct uploads auto-promote, so you do
-**not** need \`--prod\` or a separate \`promote\` step. Safe to run repeatedly;
-each run replaces what the apex serves.
-
-There is no separate per-deploy preview address: user sites live in the
-\`layero.app\` zone, which has no preview sub-zone and no CDN in front, so the
-apex is reachable the moment the deploy is ready.
-
-Hand the user \`ready.url\` and stop — that address is live.
-
-There is no way to publish without replacing the live site from the CLI:
-\`--branch\` is accepted and **silently ignored** — archive uploads are always
-filed under the reserved \`cli\` environment. If the user asks for a version
-"just to look at" that leaves the live address alone, tell them it needs a
-connected repository and a push to a branch. (\`--prod\` exists for
-git-connected projects; for direct CLI uploads it's redundant.)
-
-### Already built? Skip the server build
-
-If the site is already built locally (e.g. a Next.js static export in \`out/\`,
-or a \`dist/\`), ship the artifact directly and skip the server-side
-\`npm install\` + build:
+### Deploy from this directory
 
 \`\`\`bash
-npx layero@latest deploy --prebuilt out
+npx layero@latest deploy --json
 \`\`\`
 
-Full reference: https://docs.layero.ru/en/cli/agents
+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
+callback: the browser may be on another machine. In CI use
+\`LAYERO_TOKEN=… npx layero@latest deploy --project <slug> --json --yes\`.
+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\` /
+\`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.
+
+Exit codes: 0 ok · 2 auth (\`auth_required\`, \`auth_expired\`, \`auth_timeout\`) ·
+3 not found (\`project_unknown\`, \`project_not_found\`) · 4 invalid input
+(\`invalid_type\`, \`prebuilt_no_dir\`, \`branch_unsupported\`) · 5 remote
+(\`deploy_failed\`, \`internal\`). Codes \`not_logged_in\`, \`deploy_error\`,
+\`deploy_timed_out\` do not exist — do not branch on them.
+
+### Rules
+
+- Re-running \`deploy\` is safe and reuses the project; no commit needed.
+- A plain \`deploy\` of a CLI project **replaces the live site** at
+  \`ready.url\`: direct uploads auto-promote. \`--branch\` is refused
+  (\`branch_unsupported\`) — isolated previews come from pushing a branch of
+  a connected repository, nothing else.
+- Already built locally? \`npx layero@latest deploy --prebuilt <dir>\`.
+- Never \`git init\` just to deploy, never \`npm install -g layero\`, never
+  build the site address from a template — only \`ready.url\`.
 ${AGENT_BLOCK_MARKER_END}
 `;
 }
@@ -172,7 +149,6 @@ async function ensureGitignore(cwd) {
 }
 export async function initCmd(opts) {
     const cwd = process.cwd();
-    const mode = detectMode();
     const detected = await detectProject(cwd);
     emit({
         event: "detected",
@@ -182,6 +158,7 @@ export async function initCmd(opts) {
         confident: detected.confident,
     });
     const block = agentDocBlock(detected.framework_hint);
+    const agentDocs = [];
     if (!opts.skipAgentDocs) {
         // Touch every agent-doc convention we know about. If one already
         // exists we update it in-place; otherwise we create only the most
@@ -201,20 +178,15 @@ export async function initCmd(opts) {
         const targets = existing.length > 0 ? existing : ["AGENTS.md"];
         for (const f of targets) {
             const result = await upsertAgentDoc(cwd, f, block);
-            if (mode.interactive) {
-                console.log(chalk.green(`  ${result === "created" ? "✓ created" : result === "updated" ? "✓ updated" : "= unchanged"} ${f}`));
-            }
+            agentDocs.push({ file: f, result });
         }
     }
     const pjResult = await ensureProjectJson(cwd, detected.framework_hint, detected.build_cmd, detected.output_dir);
-    if (mode.interactive) {
-        console.log(chalk.green(`  ${pjResult === "created" ? "✓ created" : "= unchanged"} .layero/project.json`));
-    }
     await ensureGitignore(cwd);
-    if (mode.interactive) {
-        console.log("");
-        console.log(chalk.bold("Next:"));
-        console.log("  $ npx layero login    # one-time, in your browser");
-        console.log("  $ npx layero deploy   # ship the current directory");
-    }
+    emit({
+        event: "init_done",
+        framework: detected.framework_hint,
+        agent_docs: agentDocs,
+        project_json: pjResult,
+    });
 }

package/dist/commands/link.js

@@ -1,40 +1,27 @@
-import chalk from "chalk";
 import { ApiClient } from "../api.js";
 import { loadConfig } from "../config.js";
 import { persistProjectLinking } from "../project-config.js";
+import { LayeroError, emit } from "../agent.js";
 export async function linkCmd(idOrSlug) {
     const cfg = await loadConfig();
     if (!cfg.token) {
-        console.error(chalk.yellow("not logged in. run `layero login` first."));
-        process.exitCode = 1;
-        return;
+        throw new LayeroError("auth_required", "вход не выполнен", "выполните `layero login` или задайте LAYERO_TOKEN");
     }
     const api = new ApiClient(cfg);
-    // The backend accepts UUIDs only on /projects/{id}; for slug we fall back
-    // to listing — this is fine because users typically have <100 projects.
-    let proj;
-    try {
-        proj = await api.getProject(idOrSlug);
-    }
-    catch {
-        const all = await api.listProjects();
-        const match = all.find((p) => p.slug === idOrSlug);
-        if (!match) {
-            console.error(chalk.red(`no project with id/slug "${idOrSlug}"`));
-            process.exitCode = 1;
-            return;
-        }
-        proj = match;
-    }
+    // Слаг или id — различает клиент по форме значения (`resolveProject`):
+    // UUID, ушедший в поиск по слагу, не нашёлся бы.
+    const proj = await api.resolveProject(idOrSlug);
     await persistProjectLinking(process.cwd(), {
         project_id: proj.id,
         slug: proj.slug,
         organization_slug: proj.organization.slug,
         apex_hostname: proj.apex_hostname,
     }, proj.framework_hint ?? null);
-    console.log(chalk.green(`linked ${proj.slug} (${proj.id}) → ./.layero/project.json`));
-    if (proj.status === "pending_setup") {
-        console.log(chalk.yellow("  note: project is in pending_setup. finish the setup wizard in the dashboard, " +
-            "or run `layero deploy` to upload source and get the wizard URL."));
-    }
+    emit({
+        event: "project_linked",
+        project_id: proj.id,
+        slug: proj.slug,
+        url: `https://${proj.apex_hostname}`,
+        status: proj.status,
+    });
 }

package/dist/commands/logout.js

@@ -1,6 +1,6 @@
-import chalk from "chalk";
 import { clearConfig, configPath } from "../config.js";
+import { emit } from "../agent.js";
 export async function logoutCmd() {
     await clearConfig();
-    console.log(chalk.green(`logged out (removed ${configPath()})`));
+    emit({ event: "logged_out", config_path: configPath() });
 }

package/dist/commands/orgs.js

@@ -1,24 +1,20 @@
-import chalk from "chalk";
 import { ApiClient } from "../api.js";
 import { loadConfig } from "../config.js";
-/** `layero orgs list` — show every Layero organization the caller belongs to.
+import { LayeroError, emit } from "../agent.js";
+/** `layero orgs list` — организации аккаунта: личная и команды.
  *
- * Useful before `layero deploy --org=<slug>` so the user can see which
- * slugs to pass without leaving the terminal.
+ * Нужна перед `layero deploy --org=<slug>`, чтобы увидеть слаги, не выходя
+ * из терминала.
  */
 export async function orgsListCmd() {
     const cfg = await loadConfig();
-    if (!cfg.token)
-        throw new Error("not logged in. run `layero login` first.");
+    if (!cfg.token) {
+        throw new LayeroError("auth_required", "вход не выполнен", "выполните `layero login` или задайте LAYERO_TOKEN");
+    }
     const api = new ApiClient(cfg);
     const orgs = await api.listOrganizations();
-    if (orgs.length === 0) {
-        console.log(chalk.dim("no organizations on this account."));
-        return;
-    }
-    for (const o of orgs) {
-        const kindBadge = o.kind === "personal" ? chalk.dim("personal") : chalk.cyan("team");
-        const roleBadge = chalk.dim(`(${o.my_role})`);
-        console.log(`  ${chalk.bold(o.slug.padEnd(20))} ${kindBadge}  ${roleBadge}`);
-    }
+    emit({
+        event: "organizations",
+        organizations: orgs.map((o) => ({ id: o.id, slug: o.slug, kind: o.kind, role: o.my_role })),
+    });
 }