layero 0.6.1 → 0.7.0

package/README.md

@@ -71,6 +71,12 @@ Run `layero <cmd> --help` for full options.
   uses that explicit path. Use this for CI flows that build in the
   pipeline, Webflow / Framer exports, or whenever you don't want the
   platform to run install/build for you.
+- `--root <dir>` — monorepo: tell the builder the app lives in a
+  subdirectory of the repo (e.g. `--root apps/web`). Saved on the
+  project; future GitHub-push and hook triggers use the same value.
+  CLI auto-detect honours it: framework signals are looked up inside
+  `<cwd>/<root>` so a `package.json` workspace at the repo root
+  doesn't shadow the real app's stack.
 - `--name <name>` — project name (only on first deploy).
 - `--project <id_or_slug>` — deploy into an existing project, ignoring
   `./.layero/project.json` (useful for CI).
@@ -92,6 +98,7 @@ Run `layero <cmd> --help` for full options.
 | `gatsby` dep | gatsby | `npm run build` | `public` |
 | `astro` dep / `astro.config.*` | astro | `npm run build` | `dist` |
 | `@docusaurus/core` dep / `docusaurus.config.*` | docusaurus | `npm run build` | `build` |
+| `@storybook/*` dep / `scripts.build-storybook` / `.storybook/main.*` | storybook | `npm run build-storybook` (or `npx storybook build`) | `storybook-static` |
 | `vitepress` dep / `.vitepress/config.*` / `docs/.vitepress/config.*` | vitepress | `npm run docs:build` (or `npx vitepress build`) | `.vitepress/dist` or `docs/.vitepress/dist` |
 | `vite` dep / `vite.config.*` | vite | `npm run build` | `dist` |
 | `react-scripts` dep | cra | `npm run build` | `build` |

package/dist/api.js

@@ -68,6 +68,9 @@ export class ApiClient {
     completeSetup(projectId, input) {
         return this.request("POST", `/projects/${projectId}/setup`, input);
     }
+    updateProject(projectId, input) {
+        return this.request("PATCH", `/projects/${projectId}`, input);
+    }
     triggerDeploy(projectId, input) {
         return this.request("POST", `/projects/${projectId}/deploy`, input);
     }
@@ -81,6 +84,16 @@ export class ApiClient {
     rollbackProject(projectId, input) {
         return this.request("POST", `/projects/${projectId}/rollback`, input);
     }
+    // V071 production-pointer: pin apex to a specific deploy. `source` is
+    // recorded in promote_events and lets us split CLI vs UI adoption later.
+    promoteDeploy(projectId, deployId) {
+        return this.request("POST", `/projects/${projectId}/promote`, { deploy_id: deployId, source: "cli" });
+    }
+    // Clear projects.production_deploy_id — apex resumes following latest
+    // ready deploy of default_branch (or sole-env, see V071 host_resolver).
+    unpinProduction(projectId) {
+        return this.request("POST", `/projects/${projectId}/unpin`);
+    }
     listDeployHooks(projectId) {
         return this.request("GET", `/projects/${projectId}/deploy-hooks`);
     }

package/dist/bin/layero.js

@@ -11,6 +11,7 @@ import { linkCmd } from "../commands/link.js";
 import { tokenSetCmd } from "../commands/token.js";
 import { deployCmd } from "../commands/deploy.js";
 import { deploysListCmd, rollbackCmd } from "../commands/deploys.js";
+import { promoteCmd } from "../commands/promote.js";
 import { hooksCreateCmd, hooksDeleteCmd, hooksListCmd } from "../commands/hooks.js";
 import { loginCmd } from "../commands/login.js";
 import { orgsListCmd } from "../commands/orgs.js";
@@ -124,6 +125,21 @@ async function main() {
             process.exitCode = 1;
         }
     });
+    program
+        .command("promote [deploy]")
+        .description("Pin the project apex to a specific deploy (V071 production-pointer). " +
+        "Without [deploy] picks the latest ready build on --branch (defaults to the 'cli' pseudo-branch).")
+        .option("--project <id_or_slug>", "target project (default: linked .layero/project.json)")
+        .option("--branch <name>", "branch to pick latest ready deploy from (default: cli)")
+        .option("-y, --yes", "skip the confirmation prompt (CI)")
+        .addHelpText("after", "\nExamples:\n" +
+        "  $ layero promote                      # pin apex to latest ready deploy on `cli` branch\n" +
+        "  $ layero promote --branch=main        # pin apex to latest ready deploy on main\n" +
+        "  $ layero promote a3f9c2b              # pin apex to a specific commit sha\n" +
+        "  $ layero promote --yes                # CI-friendly, no prompt")
+        .action(async (deploy, opts) => {
+        await promoteCmd(deploy, opts);
+    });
     program
         .command("rollback")
         .description("Re-activate the previous successful deploy on the project's default branch.")
@@ -154,19 +170,22 @@ async function main() {
     program
         .command("deploy")
         .description("Pack the current directory and deploy it. Framework, build command and output directory are auto-detected.")
-        .option("-t, --type <preset>", "framework override (vite | vitepress | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | eleventy | hugo | static)")
+        .option("-t, --type <preset>", "framework override (vite | vitepress | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | storybook | eleventy | hugo | static)")
         .option("--name <name>", "project name (only used on first deploy)")
         .option("--project <id_or_slug>", "deploy into an existing project, ignoring local config")
         .option("-y, --yes", "non-interactive: accept defaults and skip --prod confirmation")
         .option("--config", "(legacy alias of the default behaviour — auto-detect + .layero/project.json values)")
         .option("--prebuilt [dir]", "ship an already-built artifact directory (default auto-pick: dist/build/public/out/_site/...)")
+        .option("--root <dir>", "monorepo: subdirectory inside the repo that the builder treats as the app root (saved on the project; future GitHub-push and hook triggers use the same value)")
         .option("--prod", "deploy to production (replaces apex_hostname's active deploy). Without this flag, deploys go to the project's CLI preview pseudo-branch.")
+        .option("--promote", "pin the project apex to this deploy after a successful build (V071). Works for any branch — e.g. `--promote` without --prod publishes a CLI preview straight to production.")
         .option("--branch <name>", "deploy to a specific branch's environment. Wins over --prod.")
         .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.")
         .addHelpText("after", "\nExamples:\n" +
         "  $ layero deploy                      # preview deploy (CLI pseudo-branch), auto-detect framework\n" +
         "  $ layero deploy --prod               # production deploy (interactive confirm)\n" +
         "  $ layero deploy --prod --yes         # production deploy, no prompt (CI)\n" +
+        "  $ layero deploy --promote            # preview deploy + pin apex (one-shot publish)\n" +
         "  $ layero deploy --branch=staging     # preview on a specific branch\n" +
         "  $ layero deploy --type vite          # force a framework preset\n" +
         "  $ layero deploy --json               # machine-readable output for agents")

package/dist/commands/deploy.js

@@ -26,6 +26,7 @@ const VALID_TYPES = new Set([
     "eleventy",
     "11ty",
     "vitepress",
+    "storybook",
 ]);
 function dashboardOrigin(apiUrl) {
     const override = process.env.LAYERO_DASHBOARD_URL;
@@ -201,7 +202,11 @@ async function resolvePrebuiltDir(cwd, raw) {
 // 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) {
-    const detected = await detectProject(cwd);
+    // 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".
+    const detectCwd = opts.root ? path.join(cwd, opts.root) : cwd;
+    const detected = await detectProject(detectCwd);
     emit({
         event: "detected",
         framework: detected.framework_hint,
@@ -298,9 +303,15 @@ export async function deployCmd(opts) {
             output_dir: setup.output_dir,
             analytics_enabled: persistedCfg.analytics_enabled ?? false,
             env_vars: persistedCfg.env_vars ?? {},
+            root_directory: opts.root ?? null,
         });
         emit({ event: "setup_applied" });
     }
+    else if (opts.root !== undefined) {
+        // Active project: --root patches the existing row so the *next*
+        // GitHub-pushed or hook-triggered build uses the new subdir.
+        project = await api.updateProject(project.id, { root_directory: opts.root });
+    }
     let upload = null;
     try {
         upload = await packAndUpload(api, cwd, project, prebuiltDir);
@@ -319,14 +330,31 @@ export async function deployCmd(opts) {
         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)}`);
         }
-        const liveUrl = opts.prod && !opts.branch
-            ? `https://${project.apex_hostname}`
-            : projectUrl(cliCfg.apiUrl, project.id);
+        // --promote: pin apex_hostname to this deploy after a successful
+        // build. Independent of --prod; --promote lets the typical "CLI
+        // preview branch" deploy publish straight to production in one
+        // command. Best-effort: a failure here doesn't fail the deploy
+        // (the artifact is good; promote can be retried via `layero promote`).
+        let promoted = false;
+        if (opts.promote) {
+            try {
+                await api.promoteDeploy(project.id, deploy.id);
+                promoted = true;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.warn(chalk.yellow(`warning: deploy succeeded but promote failed — ${msg}.\n` +
+                    `  retry with: layero promote ${deploy.id.slice(0, 8)}`));
+            }
+        }
+        const apexUrl = `https://${project.apex_hostname}`;
+        const previewUrl = projectUrl(cliCfg.apiUrl, project.id);
+        const liveUrl = promoted || (opts.prod && !opts.branch) ? apexUrl : previewUrl;
         emit({
             event: "ready",
             url: liveUrl,
             deploy_id: deploy.id,
-            preview_url: opts.prod && !opts.branch ? undefined : projectUrl(cliCfg.apiUrl, project.id),
+            preview_url: promoted || (opts.prod && !opts.branch) ? undefined : previewUrl,
         });
     }
     finally {

package/dist/commands/promote.js

@@ -0,0 +1,106 @@
+import readline from "node:readline/promises";
+import chalk from "chalk";
+import { ApiClient, ApiError } from "../api.js";
+import { loadConfig } from "../config.js";
+import { loadProjectConfig } from "../project-config.js";
+async function resolveProjectId(api, cwd, override) {
+    if (override) {
+        const all = await api.listProjects();
+        const match = all.find((p) => p.id === override) ?? all.find((p) => p.slug === override);
+        if (!match)
+            throw new Error(`no project with id/slug "${override}"`);
+        return match.id;
+    }
+    const cfg = await loadProjectConfig(cwd);
+    if (!cfg) {
+        throw new Error("no .layero/project.json found. cd into a linked project or pass --project <slug>.");
+    }
+    return cfg.project_id;
+}
+function shortSha(sha) {
+    return (sha ?? "").slice(0, 7);
+}
+async function confirm(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const answer = (await rl.question(`${question} [y/N]: `)).trim().toLowerCase();
+        return answer === "y" || answer === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * `layero promote [deploy]` — pin apex to a specific deploy.
+ *
+ * Without an argument: picks the latest ready deploy on --branch (or the
+ * "cli" pseudo-branch when not specified). With an argument: takes either
+ * a deploy id or a commit-sha prefix and promotes that one — same shape
+ * as `layero rollback --deploy`.
+ *
+ * Requires production_pointer_enabled=true on the project. The server
+ * returns 400 with a readable message if the flag is off; we surface it.
+ */
+export async function promoteCmd(deployArg, opts) {
+    const cliCfg = await loadConfig();
+    if (!cliCfg.token) {
+        throw new Error("not logged in. run `layero login` first.");
+    }
+    const api = new ApiClient(cliCfg);
+    const projectId = await resolveProjectId(api, process.cwd(), opts.project);
+    const project = await api.getProject(projectId);
+    let target;
+    if (deployArg) {
+        // Search across all branches — the user may know the sha but not which
+        // branch it came from. Behaviour mirrors `rollback --deploy`.
+        const all = await api.listProjectDeploys(projectId, opts.branch);
+        const m = all.find((d) => d.id === deployArg || d.commit_sha.startsWith(deployArg));
+        if (!m)
+            throw new Error(`no deploy matching "${deployArg}"`);
+        target = m;
+    }
+    else {
+        // No deploy arg → promote latest ready on the branch (defaults to "cli"
+        // pseudo-branch, which is where `layero deploy` without --branch lands).
+        const branch = opts.branch ?? "cli";
+        const all = await api.listProjectDeploys(projectId, branch);
+        const m = all.find((d) => d.status === "ready");
+        if (!m) {
+            throw new Error(`no ready deploy on branch "${branch}".`);
+        }
+        target = m;
+    }
+    if (target.status !== "ready") {
+        throw new Error(`cannot promote deploy ${shortSha(target.commit_sha)}: status is "${target.status}", not ready.`);
+    }
+    const apex = project.apex_hostname;
+    console.log(chalk.cyan("promote plan:"));
+    console.log(`  project: ${project.slug}`);
+    console.log(`  apex:    https://${apex}`);
+    console.log(`  deploy:  ${shortSha(target.commit_sha)}  ${chalk.dim((target.commit_message ?? "").split("\n")[0] ?? "")}`);
+    if (project.production_deploy_id) {
+        console.log(chalk.dim(`  current: ${project.production_deploy_id.slice(0, 8)}  (will be replaceable via re-promote)`));
+    }
+    if (!opts.yes) {
+        const ok = await confirm("publish this build to production?");
+        if (!ok) {
+            console.log(chalk.yellow("aborted."));
+            return;
+        }
+    }
+    try {
+        const updated = await api.promoteDeploy(projectId, target.id);
+        const newPin = updated.production_deploy_id ?? target.id;
+        console.log(chalk.green(`published. https://${updated.apex_hostname} now serves deploy ${newPin.slice(0, 8)}.`));
+        console.log(chalk.dim("  edge cache flushes within a few seconds; visitors see the new build immediately."));
+    }
+    catch (err) {
+        if (err instanceof ApiError) {
+            throw new Error(`promote failed (${err.status}): ${err.body.slice(0, 200)}`);
+        }
+        throw err;
+    }
+}

package/dist/detect.js

@@ -115,6 +115,46 @@ export async function detectProject(cwd) {
                 confident: true,
             };
         }
+        // Storybook before Vite/CRA: Storybook 7+ uses Vite or webpack
+        // internally, so `vite` / `react-scripts` is in deps. Without
+        // listing it first the SPA Vite path would output_dir=dist, which
+        // doesn't exist after `build-storybook`.
+        const storybookDeps = [
+            "@storybook/cli",
+            "@storybook/react",
+            "@storybook/react-vite",
+            "@storybook/react-webpack5",
+            "@storybook/vue",
+            "@storybook/vue3",
+            "@storybook/vue3-vite",
+            "@storybook/svelte",
+            "@storybook/svelte-vite",
+            "@storybook/web-components",
+            "@storybook/web-components-vite",
+            "@storybook/preact",
+            "@storybook/angular",
+            "@storybook/nextjs",
+            "@storybook/html",
+            "@storybook/html-vite",
+            "storybook",
+        ];
+        const hasStorybookDep = storybookDeps.some((d) => hasDep(pkg, d));
+        const hasStorybookScript = pkg.scripts?.["build-storybook"] !== undefined
+            || Object.values(pkg.scripts ?? {}).some((s) => typeof s === "string" && s.includes("storybook build"));
+        const hasStorybookDir = await fileExists(cwd, ".storybook/main.js", ".storybook/main.ts", ".storybook/main.cjs", ".storybook/main.mjs");
+        if (hasStorybookDep || hasStorybookScript || hasStorybookDir) {
+            const cmd = pkg.scripts?.["build-storybook"]
+                ? "npm run build-storybook"
+                : (pkg.scripts?.build && pkg.scripts.build.includes("storybook"))
+                    ? "npm run build"
+                    : "npx storybook build";
+            return {
+                framework_hint: "storybook",
+                build_cmd: cmd,
+                output_dir: "storybook-static",
+                confident: true,
+            };
+        }
         // VitePress before generic Vite: VitePress repos often pull `vite`
         // transitively, and the SPA Vite path would set output_dir=dist —
         // wrong for VitePress, which writes to `.vitepress/dist/` (or

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layero",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Layero CLI — publish a local site with one command. No git, no GitHub, agent-friendly (Cursor, Claude Code).",
   "license": "MIT",
   "type": "module",