@lizard-build/cli 0.1.0 → 0.3.30

package/dist/commands/service.js

@@ -0,0 +1,262 @@
+import chalk from "chalk";
+import * as p from "@clack/prompts";
+import { api, withScope, withQuery } from "../lib/api.js";
+import { updateProjectLink, getProjectLink } from "../lib/config.js";
+import { resolveProjectScope, resolveService } from "../lib/resolve.js";
+import { validateName } from "../lib/name.js";
+import { registerServiceSet } from "./service-set.js";
+import { registerServiceShow } from "./service-show.js";
+import { success, info, isJSONMode, printJSON, isTTY, } from "../lib/format.js";
+/**
+ * `lizard service` — service group:
+ *   - bare: link a service to cwd
+ *   - list / link / status / delete / rename / set / show / logs
+ *   (scale / redeploy / restart live on the top-level commands of the same name)
+ */
+export function registerService(program) {
+    const svc = program
+        .command("service")
+        .argument("[name]", "Service name to link (legacy form for `service link <name>`)")
+        .description("Manage services")
+        .action(async (name, _opts, cmd) => {
+        // No subcommand → behave like `service link`
+        if (!name && cmd.args.length === 0) {
+            await linkInteractive(cmd);
+            return;
+        }
+        if (name) {
+            await linkByName(cmd, name);
+        }
+    });
+    // `service set` and `service show` — per-service configuration patches.
+    // Live in their own files because the apply logic is substantial.
+    registerServiceSet(svc);
+    registerServiceShow(svc);
+    svc
+        .command("link")
+        .argument("[name]", "Service name or ID")
+        .description("Link a service to the current directory")
+        .action(async (name, _opts, sub) => {
+        if (name) {
+            await linkByName(sub, name);
+        }
+        else {
+            await linkInteractive(sub);
+        }
+    });
+    svc
+        .command("delete")
+        .alias("rm")
+        .description("Delete a service")
+        .argument("[service]", "Service name or ID (defaults to linked)")
+        .option("-s, --service <name>", "Service name or ID")
+        .option("-p, --project <id>", "Project name, slug, or ID")
+        .option("-y, --yes", "Skip confirmation")
+        .action(async (serviceArg, opts) => {
+        const { projectId, scope } = await resolveProjectScope(opts.project);
+        const target = serviceArg || opts.service || getProjectLink()?.serviceId;
+        if (!target)
+            throw new Error("No service specified or linked.");
+        const svcInfo = await resolveService(projectId, target);
+        const yes = opts.yes;
+        if (!yes) {
+            if (!isTTY())
+                throw new Error("Use -y to confirm in non-interactive mode");
+            const confirm = await p.confirm({
+                message: `Delete ${chalk.bold(svcInfo.name)}? This is irreversible.`,
+            });
+            if (p.isCancel(confirm) || !confirm)
+                process.exit(5);
+        }
+        if (svcInfo.kind === "app") {
+            await api.delete(withScope(`/api/apps/${svcInfo.id}`, scope));
+        }
+        else {
+            await api.delete(withScope(`/api/projects/${projectId}/addons/${svcInfo.id}`, scope));
+        }
+        // Clear link if we just deleted the linked service
+        const link = getProjectLink();
+        if (link?.serviceId === svcInfo.id) {
+            updateProjectLink({ serviceId: undefined, serviceName: undefined });
+        }
+        if (isJSONMode()) {
+            printJSON({ id: svcInfo.id, name: svcInfo.name, status: "deleted" });
+        }
+        else {
+            success(`Service ${chalk.bold(svcInfo.name)} deleted`);
+        }
+    });
+    svc
+        .command("rename")
+        .argument("<new-name>", "New name for the service")
+        .description("Rename a service (apps and addons)")
+        .option("-s, --service <name>", "Service name or ID (defaults to linked service)")
+        .option("-p, --project <id>", "Project name, slug, or ID")
+        .action(async (newName, opts) => {
+        const nameErr = validateName(newName);
+        if (nameErr)
+            throw new Error(`Invalid name: ${nameErr}`);
+        const { projectId, scope } = await resolveProjectScope(opts.project);
+        const target = opts.service || getProjectLink()?.serviceId;
+        if (!target)
+            throw new Error("No service specified or linked.");
+        const svcInfo = await resolveService(projectId, target);
+        if (svcInfo.kind === "app") {
+            // PATCH /api/apps/:id is 410-Gone; renames go through config:apply.
+            // Backend treats name as a rename only when id is also in the patch
+            // (otherwise name is a lookup key).
+            await api.post(withScope(`/api/projects/${projectId}/config:apply`, scope), { services: [{ id: svcInfo.id, name: newName }] });
+        }
+        else {
+            await api.patch(withScope(`/api/projects/${projectId}/addons/${svcInfo.id}`, scope), { name: newName });
+        }
+        // Keep the cwd link's cached name in sync when we just renamed the linked one.
+        const link = getProjectLink();
+        if (link?.serviceId === svcInfo.id) {
+            updateProjectLink({ serviceId: svcInfo.id, serviceName: newName });
+        }
+        if (isJSONMode()) {
+            printJSON({ id: svcInfo.id, oldName: svcInfo.name, name: newName });
+        }
+        else {
+            success(`Renamed ${chalk.bold(svcInfo.name)} → ${chalk.bold(newName)}`);
+        }
+    });
+    svc
+        .command("logs")
+        .description("Stream logs of a service")
+        .argument("[service]", "Service name or ID (defaults to linked)")
+        .option("-s, --service <name>", "Service name or ID")
+        .option("-p, --project <id>", "Project name, slug, or ID")
+        .option("--build", "Show build logs instead of runtime")
+        .option("-n, --tail <n>", "Print last N lines and exit (no follow); use --tail all for full history")
+        .option("--page <n>", "Page of historical logs (1=most recent, 2=older, …); implies --tail 200")
+        .action(async (serviceArg, opts) => {
+        const { projectId, scope } = await resolveProjectScope(opts.project);
+        const target = serviceArg || opts.service || getProjectLink()?.serviceId;
+        if (!target)
+            throw new Error("No service specified or linked.");
+        const svcInfo = await resolveService(projectId, target);
+        const { streamSSE } = await import("../lib/api.js");
+        if (opts.build) {
+            const app = await api.get(withScope(`/api/apps/${svcInfo.id}`, scope));
+            if (!app.builds?.length)
+                throw new Error("No builds found");
+            info(chalk.dim(`Streaming build logs for ${svcInfo.name}...\n`));
+            await streamSSE(`/api/builds/${app.builds[0].id}/logs`, (event, data) => {
+                if (event === "done" || event === "error")
+                    return false;
+                process.stdout.write(safeLogLine(data) + "\n");
+                return true;
+            });
+            return;
+        }
+        // --page: paginate through historical logs without streaming
+        if (opts.page !== undefined) {
+            const pageSize = 200;
+            const pageNum = Math.max(1, parseInt(opts.page, 10) || 1);
+            // Fetch pages iteratively: page 1 = most recent, page 2 = one step older, etc.
+            let before;
+            for (let p = 1; p <= pageNum; p++) {
+                const result = await api.get(withScope(withQuery(`/api/apps/${svcInfo.id}/logs/history`, {
+                    limit: pageSize,
+                    before,
+                }), scope));
+                if (p === pageNum) {
+                    if (!result.entries.length) {
+                        info(chalk.dim("No more logs."));
+                    }
+                    else {
+                        info(chalk.dim(`Page ${pageNum} (${result.entries.length} lines):\n`));
+                        for (const e of result.entries)
+                            process.stdout.write(safeLogLine(JSON.stringify(e)) + "\n");
+                        if (result.oldest)
+                            info(chalk.dim(`\n  --page ${pageNum + 1}  for older logs`));
+                    }
+                }
+                else {
+                    if (!result.entries.length || !result.entries[0])
+                        break;
+                    before = result.entries[0].id; // oldest entry of this page → upper bound for next
+                }
+            }
+            return;
+        }
+        // --tail N: fetch N historical lines and exit (no follow)
+        if (opts.tail !== undefined) {
+            const rawTail = String(opts.tail);
+            const limit = rawTail === "all" ? 2000 : Math.min(Math.max(1, parseInt(rawTail, 10) || 200), 2000);
+            const result = await api.get(withScope(withQuery(`/api/apps/${svcInfo.id}/logs/history`, { limit }), scope));
+            for (const e of result.entries)
+                process.stdout.write(safeLogLine(JSON.stringify(e)) + "\n");
+            if (result.oldest && result.entries.length === limit) {
+                info(chalk.dim(`\n  Showing last ${limit} lines. Use --tail all or --page 2 to see older logs.`));
+            }
+            return;
+        }
+        info(chalk.dim(`Streaming logs for ${svcInfo.name}... (Ctrl+C to stop)\n`));
+        await streamSSE(withScope(withQuery(`/api/apps/${svcInfo.id}/logs`, { limit: 500 }), scope), (event, data) => {
+            if (event === "error")
+                return false;
+            process.stdout.write(safeLogLine(data) + "\n");
+            return true;
+        });
+    });
+    // Helpers in scope of registerService
+    async function linkByName(_cmd, name) {
+        const { projectId } = await resolveProjectScope(undefined);
+        const svcInfo = await resolveService(projectId, name);
+        updateProjectLink({ serviceId: svcInfo.id, serviceName: svcInfo.name });
+        if (isJSONMode()) {
+            printJSON({ serviceId: svcInfo.id, serviceName: svcInfo.name });
+        }
+        else {
+            success(`Linked service ${chalk.bold(svcInfo.name)}`);
+        }
+    }
+    async function linkInteractive(_cmd) {
+        const { projectId, scope } = await resolveProjectScope(undefined);
+        const data = await api.get(withScope(`/api/projects/${projectId}/services`, scope));
+        const services = [...(data.apps || []), ...(data.addons || [])];
+        if (services.length === 0) {
+            throw new Error("No services in project. Use `lizard add` first.");
+        }
+        if (!isTTY()) {
+            throw new Error("Service name required in non-interactive mode. Usage: `lizard service link <name>`");
+        }
+        const sel = await p.select({
+            message: "Select a service",
+            options: services.map((s) => ({
+                value: s.id,
+                label: s.name || s.addonType,
+                hint: s.status,
+            })),
+        });
+        if (p.isCancel(sel))
+            process.exit(5);
+        const svcInfo = services.find((s) => s.id === sel);
+        updateProjectLink({ serviceId: svcInfo.id, serviceName: svcInfo.name });
+        if (isJSONMode()) {
+            printJSON({ serviceId: svcInfo.id, serviceName: svcInfo.name });
+        }
+        else {
+            success(`Linked service ${chalk.bold(svcInfo.name)}`);
+        }
+    }
+}
+function safeLogLine(data) {
+    try {
+        const parsed = JSON.parse(data);
+        if (parsed.line)
+            return parsed.line;
+        if (parsed.message)
+            return parsed.message;
+        if (typeof parsed === "string")
+            return parsed;
+        return data;
+    }
+    catch {
+        return data;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/commands/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/commands/service.ts"],"names":[],"mappings":"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"}

package/dist/commands/skill.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerSkill(program: Command): void;

package/dist/commands/skill.js

@@ -0,0 +1,146 @@
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import { error, info, isJSONMode, printJSON, table } from "../lib/format.js";
+const DEFAULT_SKILLS_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "skill-data");
+function skillsDir() {
+    return process.env.LIZARD_SKILLS_DIR || DEFAULT_SKILLS_DIR;
+}
+function listSkills() {
+    const dir = skillsDir();
+    try {
+        return readdirSync(dir)
+            .filter((name) => {
+            const p = path.join(dir, name);
+            try {
+                return statSync(p).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        })
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+function skillFile(name) {
+    return path.join(skillsDir(), name, "SKILL.md");
+}
+// Minimal YAML-ish frontmatter parser. Pulls top-level scalar keys (name,
+// description, etc.) — enough to render `lizard skill list`. Full YAML parsing
+// would add a dependency for no real win.
+function parseFrontmatter(md) {
+    if (!md.startsWith("---"))
+        return {};
+    const end = md.indexOf("\n---", 3);
+    if (end === -1)
+        return {};
+    const body = md.slice(3, end).replace(/^\r?\n/, "");
+    const out = {};
+    for (const raw of body.split(/\r?\n/)) {
+        const m = raw.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (!m)
+            continue;
+        let val = m[2].trim();
+        if ((val.startsWith('"') && val.endsWith('"')) ||
+            (val.startsWith("'") && val.endsWith("'"))) {
+            val = val.slice(1, -1);
+        }
+        out[m[1]] = val;
+    }
+    return out;
+}
+function readSkill(name) {
+    const file = skillFile(name);
+    let md;
+    try {
+        md = readFileSync(file, "utf8");
+    }
+    catch {
+        throw new Error(`Skill '${name}' not found. Run \`lizard skill list\` to see available skills.`);
+    }
+    return { md, meta: parseFrontmatter(md) };
+}
+function shortDesc(desc, max = 100) {
+    const oneLine = desc.replace(/\s+/g, " ").trim();
+    return oneLine.length > max ? oneLine.slice(0, max - 1) + "…" : oneLine;
+}
+export function registerSkill(program) {
+    const skill = program
+        .command("skill")
+        .description("Read embedded agent skills shipped with this CLI version");
+    skill
+        .command("list")
+        .description("List available skills with descriptions")
+        .action(() => {
+        const names = listSkills();
+        if (isJSONMode()) {
+            printJSON({
+                dir: skillsDir(),
+                skills: names.map((n) => {
+                    try {
+                        const { meta } = readSkill(n);
+                        return { name: n, description: meta.description || "" };
+                    }
+                    catch {
+                        return { name: n, description: "" };
+                    }
+                }),
+            });
+            return;
+        }
+        if (names.length === 0) {
+            info("No skills found.");
+            return;
+        }
+        const rows = names.map((n) => {
+            try {
+                const { meta } = readSkill(n);
+                return [n, shortDesc(meta.description || "")];
+            }
+            catch {
+                return [n, ""];
+            }
+        });
+        table(["name", "description"], rows);
+    });
+    skill
+        .command("get")
+        .description("Print a skill's full content (markdown)")
+        .argument("<name>", "skill name (e.g. core)")
+        .option("--full", "Include reference files (reserved; currently equivalent to default)")
+        .action((name, _opts) => {
+        try {
+            const { md, meta } = readSkill(name);
+            if (isJSONMode()) {
+                printJSON({
+                    name,
+                    path: skillFile(name),
+                    frontmatter: meta,
+                    content: md,
+                });
+                return;
+            }
+            process.stdout.write(md.endsWith("\n") ? md : md + "\n");
+        }
+        catch (e) {
+            error(e.message);
+            process.exit(3);
+        }
+    });
+    skill
+        .command("path")
+        .description("Print the filesystem path of a skill (or the skills root)")
+        .argument("[name]", "skill name; omit to print the skills directory")
+        .action((name) => {
+        const target = name ? skillFile(name) : skillsDir();
+        if (isJSONMode()) {
+            printJSON({ path: target });
+            return;
+        }
+        console.log(target);
+    });
+}
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"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"}

package/dist/commands/ssh.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerSSH(program: Command): void;

package/dist/commands/ssh.js

@@ -0,0 +1,161 @@
+import chalk from "chalk";
+import * as p from "@clack/prompts";
+import { api, getBaseURL, withScope } from "../lib/api.js";
+import { resolveProjectScope } from "../lib/resolve.js";
+import { error, isTTY } from "../lib/format.js";
+import { getToken } from "../lib/auth.js";
+import * as https from "node:https";
+import * as http from "node:http";
+export function registerSSH(program) {
+    program
+        .command("ssh")
+        .description("Execute a command inside a running service VM")
+        .argument("[cmd...]", "Command and args to run inside the VM (required; pass after `--` to stop flag parsing, e.g. `-- ls -la /app`)")
+        .option("-s, --service <id>", "Service name or ID")
+        .option("-p, --project <id>", "Project name, slug, or ID")
+        .addHelpText("after", `
+Examples:
+  lizard ssh -s my-app -- ls -la /app
+  lizard ssh -s my-app -- printenv
+  lizard ssh -s my-app -- bash -c "ps aux | head"`)
+        .action(async (cmdArgs, opts) => {
+        const { projectId, scope } = await resolveProjectScope(opts.project);
+        let serviceId = opts.service;
+        // Resolve service interactively if not given
+        if (!serviceId) {
+            const data = await api.get(withScope(`/api/projects/${projectId}/services`, scope));
+            const running = (data.apps || []).filter((a) => a.status === "running");
+            if (running.length === 0) {
+                error("No running services in this project.");
+                process.exit(1);
+            }
+            if (running.length === 1) {
+                serviceId = running[0].id;
+            }
+            else if (isTTY()) {
+                const selected = await p.select({
+                    message: "Select a service",
+                    options: running.map((a) => ({ value: a.id, label: a.name || a.id, hint: a.status })),
+                });
+                if (p.isCancel(selected))
+                    process.exit(5);
+                serviceId = selected;
+            }
+            else {
+                error("Multiple services — pass -s <service>");
+                process.exit(1);
+            }
+        }
+        // Resolve service ID if a name was given (lookup by name)
+        if (serviceId && !serviceId.match(/^[A-Za-z0-9_-]{20,}$/)) {
+            const data = await api.get(withScope(`/api/projects/${projectId}/services`, scope));
+            const match = (data.apps || []).find((a) => a.name === serviceId || a.serviceName === serviceId || a.id === serviceId);
+            if (match)
+                serviceId = match.id;
+        }
+        if (cmdArgs.length === 0) {
+            error("No command given. Usage: lizard ssh -s <service> -- <cmd> [args...]");
+            process.exit(1);
+        }
+        // The server executes `cmd` via shell on the VM, so each arg must be
+        // shell-quoted before being joined — otherwise `bash -c "ps | head"`
+        // collapses to `bash -c ps | head` (quotes lost, `|` becomes a real pipe).
+        const cmd = cmdArgs.map(shellQuote).join(" ");
+        process.stdout.write(chalk.dim(`$ ${cmd}\n`));
+        let exitCode = 0;
+        await execStream(serviceId, cmd, (stream, line) => {
+            if (stream === "stderr") {
+                process.stderr.write(line + "\n");
+            }
+            else {
+                process.stdout.write(line + "\n");
+            }
+        }, (code) => {
+            exitCode = code;
+        });
+        process.exit(exitCode);
+    });
+}
+function execStream(appId, cmd, onLine, onExit) {
+    return new Promise((resolve, reject) => {
+        const baseURL = getBaseURL();
+        const url = new URL(`${baseURL}/api/apps/${appId}/exec`);
+        const token = getToken();
+        const body = JSON.stringify({ cmd });
+        const reqHeaders = {
+            "Content-Type": "application/json",
+            "Content-Length": String(Buffer.byteLength(body)),
+            "Accept": "text/event-stream",
+        };
+        if (token)
+            reqHeaders["Authorization"] = `Bearer ${token}`;
+        const transport = url.protocol === "https:" ? https : http;
+        const req = transport.request({
+            hostname: url.hostname,
+            port: url.port || (url.protocol === "https:" ? 443 : 80),
+            path: url.pathname,
+            method: "POST",
+            headers: reqHeaders,
+        }, (res) => {
+            if (res.statusCode && res.statusCode >= 400) {
+                let body = "";
+                res.on("data", (c) => (body += c.toString()));
+                res.on("end", () => reject(new Error(`exec failed ${res.statusCode}: ${body}`)));
+                return;
+            }
+            let buf = "";
+            let currentEvent = "";
+            res.setEncoding("utf8");
+            res.on("data", (chunk) => {
+                buf += chunk;
+                const lines = buf.split("\n");
+                buf = lines.pop() ?? "";
+                for (const line of lines) {
+                    const trimmed = line.replace(/\r$/, "");
+                    if (trimmed === "") {
+                        currentEvent = "";
+                    }
+                    else if (trimmed.startsWith("event:")) {
+                        currentEvent = trimmed.slice(6).trim();
+                    }
+                    else if (trimmed.startsWith("data:")) {
+                        const data = trimmed.slice(5).trimStart();
+                        if (currentEvent === "exit") {
+                            try {
+                                onExit(JSON.parse(data).exitCode ?? 0);
+                            }
+                            catch { }
+                        }
+                        else if (currentEvent === "error") {
+                            error(data);
+                        }
+                        else {
+                            try {
+                                const parsed = JSON.parse(data);
+                                onLine(parsed.stream ?? "stdout", parsed.line ?? data);
+                            }
+                            catch {
+                                onLine("stdout", data);
+                            }
+                        }
+                    }
+                }
+            });
+            res.on("end", resolve);
+            res.on("error", reject);
+        });
+        req.on("error", reject);
+        req.write(body);
+        req.end();
+    });
+}
+/** POSIX single-quote escaping. Safe-token chars pass through verbatim;
+ *  anything else gets wrapped in '…' with embedded `'` rewritten as `'\''`. */
+function shellQuote(arg) {
+    if (arg === "")
+        return "''";
+    if (/^[A-Za-z0-9_./:=@%+,-]+$/.test(arg))
+        return arg;
+    return "'" + arg.replace(/'/g, "'\\''") + "'";
+}
+//# sourceMappingURL=ssh.js.map

package/dist/commands/ssh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.js","sourceRoot":"","sources":["../../src/commands/ssh.ts"],"names":[],"mappings":"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"}

package/dist/commands/status.d.ts

@@ -1,2 +1,9 @@
 import { Command } from "commander";
+/**
+ * `lizard status` — print the linked workspace / project / service for
+ * the current working directory. Mirrors `railway status`.
+ *
+ * Lazy-fills workspaceId into the link when missing so legacy configs
+ * surface their workspace too.
+ */
 export declare function registerStatus(program: Command): void;