layero 0.11.0 → 0.11.2

package/dist/bin/layero.js

@@ -79,7 +79,7 @@ async function main() {
     });
     program
         .command("init")
-        .description("Scaffold .layero/project.json from the auto-detected framework, and write a Layero deployment block into your agent-instructions file so future chat sessions know how to deploy. Updates whichever of AGENTS.md / CLAUDE.md / .cursorrules already exist; if none do, creates AGENTS.md.")
+        .description("Optional. Write a Layero deployment block into your agent-instructions file so future chat sessions know how to deploy (updates whichever of AGENTS.md / CLAUDE.md / .cursorrules already exist; if none do, creates AGENTS.md), and create .layero/project.json — this folder's link to its Layero project, filled in by the first deploy. No detected settings are recorded: build settings live in layero.json (committed with the code) or in the project settings. `deploy` links the folder by itself, so init is never required.")
         .option("-y, --yes", "non-interactive: accept all defaults")
         .option("--skip-agent-docs", "do not touch AGENTS.md / CLAUDE.md / .cursorrules")
         .action(async (opts) => {
@@ -429,7 +429,7 @@ async function main() {
         "Framework, build command and output directory are detected by the platform; --dry-run shows the plan first.")
         .option("--dry-run", "show how the platform will build this folder (framework, build command, output folder, where each came from, " +
         "hints for monorepos / frontend+backend / custom build scripts) and exit; uploads nothing, needs no login")
-        .option("-t, --type <preset>", "type override — static preset (vite | vitepress | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | storybook | eleventy | hugo | static) " +
+        .option("-t, --type <preset>", "type override — static preset (vite | vitepress | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | storybook | eleventy | hugo | static | generic) " +
         "or runtime kind for apps the platform RUNS (node_web | python_web | flask | streamlit | gradio | ssr_next; aliases: express, fastapi, django, node, python). " +
         "`static` serves the files as they are and never runs a build; `generic` runs your own build command " +
         "(layero.json buildCommand or the package.json build script) and serves the folder with index.html")

package/dist/commands/claim.js

@@ -76,6 +76,27 @@ export function claimTokenFor(cfg, projectId) {
         return undefined;
     return cfg.claim_tokens?.[projectId];
 }
+/**
+ * Конфиг с токеном, которым можно ЧИТАТЬ проект этой папки.
+ *
+ * 🚨 Песочница (`deploy --claim`) — тоже вход. Её токен лежит в
+ * `~/.layero/config.json` по id проекта, и прав на чтение хватает; без этой
+ * ветки агент без аккаунта получал на упавшей сборке совет «выполни
+ * `layero login`» и не мог узнать причину отказа ничем, кроме панели, которая
+ * ему недоступна (T-20260918-8). Для `diagnose`, `logs`, `deploys list` — то,
+ * что читает; действия, меняющие сайт, этим путём не ходят.
+ */
+export 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");
+}
 function claimUrlFor(cfg, code) {
     return `${dashboardOrigin(cfg.apiUrl)}/claim?code=${encodeURIComponent(code)}`;
 }

package/dist/commands/deploy.js

@@ -572,7 +572,13 @@ export async function deployCmd(opts) {
         }
     }
     else if (opts.claim) {
-        throw new LayeroError("bad_format", "--claim — деплой без аккаунта, а вход уже выполнен", "уберите --claim: проект создастся в вашем аккаунте; либо `layero logout` перед `--claim`");
+        // 🚨 Совет НЕ предлагает `logout`. Агенты исполняют `next_action`
+        // дословно, а `logout` стирает сохранённый вход и токены песочниц — войти
+        // заново может только человек. Прогон evals 19.09: агент с чужим входом на
+        // машине сделал ровно это и оставил владельца без CLI.
+        throw new LayeroError("bad_format", "--claim — деплой без аккаунта, а на этой машине уже выполнен вход", "run the same command without --claim: the project is created in the signed-in account " +
+            "(`npx layero@latest whoami` shows which). Do not run `layero logout` for someone else — " +
+            "it deletes the saved login, and only a person can sign in again");
     }
     const api = new ApiClient(cliCfg);
     // 🚨 `--branch` У АРХИВНОЙ ЗАГРУЗКИ НЕ РАБОТАЕТ, И МОЛЧАТЬ ОБ ЭТОМ НЕЛЬЗЯ.

package/dist/commands/deploys.js

@@ -2,6 +2,7 @@ import readline from "node:readline/promises";
 import chalk from "chalk";
 import { ApiClient, ApiError } from "../api.js";
 import { loadConfig } from "../config.js";
+import { configForFolder } from "./claim.js";
 import { loadProjectConfig } from "../project-config.js";
 import { detectMode, LayeroError } from "../agent.js";
 async function resolveProjectId(api, cwd, override) {
@@ -52,9 +53,10 @@ function fmtSource(d) {
     return chalk.dim("(push)");
 }
 export async function deploysListCmd(opts) {
-    const cliCfg = await loadConfig();
-    if (!cliCfg.token)
-        throw new Error("not logged in. run `layero login` first.");
+    // Токеном песочницы тоже: совет при отменённой выкатке ведёт сюда, и агент
+    // без аккаунта получал «not logged in» там, где `logs` и `diagnose` уже
+    // работали (прогон evals 19.09).
+    const cliCfg = await configForFolder(opts, process.cwd());
     const api = new ApiClient(cliCfg);
     const projectId = await resolveProjectId(api, process.cwd(), opts.project);
     const deploys = await api.listProjectDeploys(projectId, opts.branch);

package/dist/commands/diagnose.js

@@ -1,9 +1,8 @@
 import chalk from "chalk";
 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";
+import { configForFolder } from "./claim.js";
 async function resolveDeployId(api, opts, cwd) {
     if (opts.deploy) {
         // Явно указанный деплой: проект знать не обязательно, ручка работает
@@ -36,26 +35,6 @@ 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 configForFolder(opts, process.cwd());

package/dist/detect.js

@@ -361,17 +361,34 @@ async function shapeOf(cwd, snap, plan) {
     const start = scriptOf(pkg, "start");
     const serverEntry = await findServerEntry(cwd, pkg);
     if (start || serverEntry) {
-        const cmd = start ? "npm start" : `node ${serverEntry}`;
+        // Без скрипта `start` сборщик приложений перебирает свой список точек
+        // входа (server.js, index.js, …) и `server.mjs` не находит — одного
+        // `-t node_web` мало, команду запуска надо назвать (кейс a3).
         return {
             hint: `This looks like a Node server (${start ? `start script \`${start}\`` : `${serverEntry} calls listen()`}), ` +
                 "but no known server framework was recognised. A server has to be run in a container, not served as files.",
-            next_action: `npx layero@latest deploy -t node_web  (or layero.json: {"runtime":"node_web","startCommand":"${cmd}"})`,
+            next_action: start
+                ? `npx layero@latest deploy -t node_web  (the start script runs the server)`
+                : `create layero.json: {"runtime":"node_web","startCommand":"node ${serverEntry}"}`,
         };
     }
     if (snap.requirementsTxt !== null || snap.files.has("pyproject.toml")) {
+        const app = await findPythonApp(cwd);
+        if (app) {
+            // Детект платформы ищет точку входа только в корне (main.py, app.py…);
+            // приложение в пакете (`service/web.py`) он не видит. Кейс b3.
+            const cmd = app.kind === "wsgi"
+                ? `gunicorn ${app.target} --bind 0.0.0.0:$PORT`
+                : `uvicorn ${app.target} --host 0.0.0.0 --port $PORT`;
+            return {
+                hint: `A Python web app (${app.framework}) whose entry is not at the root: \`${app.target}\`. ` +
+                    "The platform looks for main.py / app.py at the root, so name the app and how to start it.",
+                next_action: `create layero.json: {"runtime":"python_web","startCommand":"${cmd}"}`,
+            };
+        }
         return {
             hint: "A Python project, but no known web framework or entry file was recognised.",
-            next_action: 'npx layero@latest deploy -t python_web  (or layero.json: {"runtime":"python_web","startCommand":"uvicorn main:app --host 0.0.0.0 --port $PORT"})',
+            next_action: 'npx layero@latest deploy -t python_web  (or layero.json: {"runtime":"python_web","startCommand":"uvicorn <module>:<app> --host 0.0.0.0 --port $PORT"})',
         };
     }
     return {
@@ -379,7 +396,60 @@ async function shapeOf(cwd, snap, plan) {
         next_action: "run the command from the app's folder (or pass --root <dir>); ready-made files: npx layero@latest deploy --prebuilt <dir>",
     };
 }
+/**
+ * Каталог результата, заданный ФЛАГОМ в скрипте сборки (`vite build --outDir
+ * public_html`). Детект читает конфиги, а не флаги, — сборщик без
+ * `outputDirectory` ищет в умолчании фреймворка и может отдать исходный
+ * `index.html` из корня вместо собранного. Кейс «слепого» агента b1.
+ */
+const OUTDIR_FLAG_RE = /(?:^|\s)--(?:outDir|out-dir|outdir|output-dir|dist-dir)(?:=|\s+)(["']?)([^\s"'&|;]+)\1/;
+function outDirFlag(pkg) {
+    const m = OUTDIR_FLAG_RE.exec(scriptOf(pkg, "build") ?? "");
+    return m ? m[2].replace(/^\.\//, "").replace(/\/+$/, "") || null : null;
+}
 const SERVER_ENTRY_CANDIDATES = ["server.js", "index.js", "app.js", "main.js", "server.mjs", "index.mjs"];
+// `api = FastAPI(`, `app = Flask(__name__)` — объект приложения на верхнем
+// уровне модуля. ASGI запускает uvicorn, WSGI — gunicorn.
+const PY_APP_RE = /^(\w+)\s*=\s*(FastAPI|Starlette|Flask|Quart|Litestar)\s*\(/m;
+const PY_ASGI = new Set(["FastAPI", "Starlette", "Quart", "Litestar"]);
+const PY_SKIP = new Set([".venv", "venv", "env", "node_modules", ".git", "__pycache__", "site-packages", "tests", "test"]);
+async function findPythonApp(cwd, maxDepth = 3) {
+    const found = [];
+    async function walk(rel, depth) {
+        if (depth > maxDepth || found.length > 3)
+            return;
+        let entries;
+        try {
+            entries = await fs.readdir(path.join(cwd, rel), { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const child = rel ? `${rel}/${e.name}` : e.name;
+            if (e.isFile() && e.name.endsWith(".py")) {
+                const text = await readText(path.join(cwd, child));
+                const m = text ? PY_APP_RE.exec(text.slice(0, 64 * 1024)) : null;
+                if (m)
+                    found.push({ rel: child, name: m[1], framework: m[2] });
+            }
+            else if (e.isDirectory() && !PY_SKIP.has(e.name) && !e.name.startsWith(".")) {
+                await walk(child, depth + 1);
+            }
+        }
+    }
+    await walk("", 0);
+    // Одно приложение — называем; несколько — гадать, какое главное, не берёмся.
+    if (found.length !== 1)
+        return null;
+    const f = found[0];
+    const module = f.rel.replace(/\.py$/, "").replace(/\//g, ".").replace(/\.__init__$/, "");
+    return {
+        target: `${module}:${f.name}`,
+        framework: f.framework,
+        kind: PY_ASGI.has(f.framework) ? "asgi" : "wsgi",
+    };
+}
 const LISTEN_RE = /\.listen\s*\(|createServer\s*\(/;
 async function findServerEntry(cwd, pkg) {
     const names = [...(typeof pkg?.main === "string" ? [pkg.main] : []), ...SERVER_ENTRY_CANDIDATES];
@@ -461,11 +531,18 @@ export async function detectProject(cwd, opts = {}) {
             ? (opts.hintSource ?? "--type")
             : "detected";
     if (plan.runtimeKind !== null) {
-        const fromFile = layero !== null && (str(layero.runtime) !== null || plan.projectKind === "fullstack");
+        // Файл объявил, КАК запускать (`runtime`, фуллстек-блоки), — это не то же
+        // самое, что назвать фреймворк: имя (`fastapi`, `express`) детект берёт из
+        // зависимостей. Без этого различия `sources.framework` приписывал файлу
+        // ключ, которого в нём нет (прогон evals 19.09, кейс b3).
+        const kindFromFile = layero !== null && (str(layero.runtime) !== null || plan.projectKind === "fullstack");
+        const nameFromFile = fileFramework !== null ||
+            (plan.projectKind === "fullstack" && str(layero?.backend?.framework) !== null);
         const sources = {
-            framework: (fromFile ? "layero.json" : frameworkSource),
+            framework: (nameFromFile ? "layero.json" : frameworkSource),
             build_cmd: "none",
             output_dir: "none",
+            runtime_kind: (kindFromFile ? "layero.json" : "detected"),
         };
         if (plan.projectType === "ssr_next") {
             // SSR Next builds in the runtime-builder; surface the framework + the
@@ -507,6 +584,7 @@ export async function detectProject(cwd, opts = {}) {
     let confident = declared || plan.confident;
     let shape = null;
     const notes = [];
+    let flagNextAction;
     if (framework === "static") {
         // Статика не собирается НИКОГДА: команда сборки у неё не «true», а
         // отсутствует. Заглушка `true` читалась как команда и уезжала в проект.
@@ -555,6 +633,16 @@ export async function detectProject(cwd, opts = {}) {
             confident = false;
             shape = await shapeOf(cwd, snap, plan);
         }
+        const flagDir = fileOutput ? null : outDirFlag(snap.packageJson);
+        if (flagDir && flagDir !== outputDir) {
+            // План платформы положит результат не туда: она не читает флаги скрипта.
+            confident = false;
+            notes.push(`The build script sets the output folder with a flag (\`${flagDir}\`), which detection does not read: ` +
+                `without outputDirectory the platform looks in "${outputDir ?? "dist"}" and may serve the source index.html instead of the build.`);
+            flagNextAction = snap.layeroJson
+                ? `add "outputDirectory": "${flagDir}" to layero.json`
+                : `create layero.json: {"outputDirectory":"${flagDir}"}`;
+        }
         if (framework === "generic" && buildCmd === null) {
             // Собирать нечем — и каталог результата у такой папки не «dist по
             // умолчанию», а неизвестен: умолчание фреймворка «Other» здесь вымысел.
@@ -575,7 +663,7 @@ export async function detectProject(cwd, opts = {}) {
         confident,
         sources: { framework: frameworkSource, build_cmd: buildSource, output_dir: outputSource },
         ...(hint ? { hint } : {}),
-        ...(shape?.next_action ? { next_action: shape.next_action } : {}),
+        ...(shape?.next_action ?? flagNextAction ? { next_action: shape?.next_action ?? flagNextAction } : {}),
         ...(shape?.candidates?.length ? { candidates: shape.candidates } : {}),
         ...(warning ? { ssr_warning: warning } : {}),
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layero",
-  "version": "0.11.0",
+  "version": "0.11.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",