@enter-pro/enter-cli 0.4.0

package/dist/commands/project.js

@@ -0,0 +1,452 @@
+import { Command } from "commander";
+import { writeFileSync } from "fs";
+import * as client from "../client.js";
+import { print, printMessage, printResult, printTable, pickList, getFormat } from "../output.js";
+import { pollUntil, TimeoutError } from "../poll.js";
+import { resolveLifecycleStatus } from "../lifecycle.js";
+export const projectCmd = new Command("project")
+    .alias("proj")
+    .description("Manage projects");
+// `/v1/projects/{id}/detail` sometimes wraps the project under `.project` and
+// sometimes returns the bare project shape — depending on the field. Normalize.
+function unwrapProject(detail) {
+    const d = detail;
+    return (d.project ?? d);
+}
+function readPublishStatus(project) {
+    const ps = project.publish_status;
+    const lastPublishedCommit = String(ps?.last_published_commit_id ?? "");
+    const lastPublishedAt = String(ps?.last_published_at ?? "");
+    const unpublishedChanges = Number(ps?.unpublished_changes ?? 0);
+    return {
+        lastPublishedCommit,
+        lastPublishedAt,
+        unpublishedChanges,
+        isPublished: Boolean(lastPublishedCommit) && unpublishedChanges === 0,
+    };
+}
+projectCmd
+    .command("list <workspace_id>")
+    .description("List projects in a workspace")
+    .option("--page <number>", "Page number", "1")
+    .option("--page-size <number>", "Page size", "20")
+    .action(async (id, opts, cmd) => {
+    const params = {
+        page: opts.page,
+        page_size: opts.pageSize,
+    };
+    const data = await client.get(`/v1/workspaces/${id}/projects`, params);
+    const resp = data;
+    const items = pickList(resp.projects || [], [
+        "project_id", "name", "status", "visibility", "preview_url", "updated_at",
+    ]);
+    const result = { items, total: resp.total, page: resp.page, page_size: resp.page_size };
+    const format = getFormat(cmd);
+    if (format !== "table") {
+        print(format, result);
+        return;
+    }
+    const rows = items.map((p) => [
+        String(p.project_id ?? ""),
+        String(p.name ?? ""),
+        String(p.status ?? ""),
+        String(p.visibility ?? ""),
+        String(p.updated_at ?? ""),
+    ]);
+    printTable(["Project ID", "Name", "Status", "Visibility", "Updated"], rows);
+});
+projectCmd
+    .command("get <project_id>")
+    .description("Get project details")
+    .action(async (id, _opts, cmd) => {
+    const data = await client.get(`/v1/projects/${id}/detail`);
+    const p = data;
+    const lifecycle = resolveLifecycleStatus(p);
+    const enriched = { ...p, lifecycle_status: lifecycle };
+    const format = getFormat(cmd);
+    if (format !== "table") {
+        print(format, enriched);
+        return;
+    }
+    printTable(["Project ID", "Name", "Visibility", "Status", "Lifecycle", "Preview URL", "Workspace", "Updated"], [[
+            String(p.project_id ?? ""),
+            String(p.name ?? ""),
+            String(p.visibility ?? ""),
+            String(p.status ?? ""),
+            lifecycle,
+            String(p.preview_url ?? ""),
+            String(p.workspace_id ?? ""),
+            String(p.updated_at ?? ""),
+        ]]);
+});
+projectCmd
+    .command("create <workspace_id>")
+    .description("Create a new project in a workspace")
+    .option("--name <name>", "Project name")
+    .option("--prompt <text>", "Initial prompt for the project")
+    .option("--model <id>", "Pin AI model (see `enter-cli models list`). Invalid IDs silently fall back to 'auto'.")
+    .option("--plan-mode", "Start the project in Plan Mode (first turn produces a plan instead of code)")
+    .option("--wait", "Wait until the first build completes")
+    .option("--timeout <seconds>", "Timeout for --wait in seconds", "300")
+    .action(async (id, opts, cmd) => {
+    const body = {};
+    if (opts.name)
+        body.name = opts.name;
+    if (opts.prompt)
+        body.prompt = opts.prompt;
+    if (opts.model)
+        body.model_id = opts.model;
+    if (opts.planMode)
+        body.plan_mode = true;
+    const data = await client.post(`/v1/workspaces/${id}/projects`, body);
+    if (!opts.wait) {
+        print(getFormat(cmd), data);
+        return;
+    }
+    const created = data;
+    const projectId = String(created.project_id ?? created.id ?? "");
+    if (!projectId) {
+        print(getFormat(cmd), data);
+        return;
+    }
+    console.error("Waiting for first build to complete...");
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const buildingStatuses = new Set(["initializing", "building"]);
+    try {
+        const result = await pollUntil(() => client.get(`/v1/projects/${projectId}/detail`), (d) => !buildingStatuses.has(String(d.status ?? "")), {
+            intervalMs: 3000,
+            timeoutMs,
+            onTick: (elapsed) => {
+                process.stderr.write(`\rWaiting... ${Math.round(elapsed / 1000)}s elapsed`);
+            },
+        });
+        process.stderr.write("\n");
+        const enriched = { ...result, lifecycle_status: resolveLifecycleStatus(result) };
+        print(getFormat(cmd), enriched);
+    }
+    catch (err) {
+        if (err instanceof TimeoutError) {
+            console.error(`\nTimed out after ${opts.timeout}s. Project may still be building.`);
+            process.exit(1);
+        }
+        throw err;
+    }
+});
+projectCmd
+    .command("rename <project_id> <new_name>")
+    .description("Rename a project")
+    .action(async (id, name, _opts, cmd) => {
+    await client.post(`/v1/projects/${id}/rename`, { name });
+    printResult(getFormat(cmd), { project_id: id, name }, `Project renamed to "${name}".`);
+});
+projectCmd
+    .command("delete <project_id>")
+    .description("Delete a project")
+    .action(async (id, _opts, cmd) => {
+    await client.del(`/v1/projects/${id}/delete`);
+    printResult(getFormat(cmd), { project_id: id, deleted: true }, "Project deleted successfully.");
+});
+projectCmd
+    .command("download <project_id>")
+    .description("Download project as zip file")
+    .option("--out <path>", "Output file path")
+    .action(async (id, opts) => {
+    const data = await client.getRaw(`/v1/projects/${id}/download`);
+    const outPath = opts.out || `${id}.zip`;
+    writeFileSync(outPath, Buffer.from(await data.arrayBuffer()));
+    printMessage(`Project downloaded to ${outPath}`);
+});
+projectCmd
+    .command("publish <project_id>")
+    .description("Publish a project (synchronous: waits for completion and verifies URL)")
+    .option("--timeout <seconds>", "Timeout in seconds", "300")
+    .action(async (id, opts, cmd) => {
+    const initialDetail = await client.get(`/v1/projects/${id}/detail`);
+    const initialProject = unwrapProject(initialDetail);
+    const buildStatus = initialProject.build_status;
+    const commitId = String(buildStatus?.commit_id ?? initialProject.commit ?? "");
+    if (!commitId) {
+        console.error("Error: project has no committed build yet (build_status.commit_id is empty).");
+        console.error("Wait for the latest turn to finish, then retry.");
+        process.exit(1);
+    }
+    await client.post(`/v1/projects/${id}/publish`);
+    console.error("Waiting for publish to complete...");
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    try {
+        const result = await pollUntil(() => client.get(`/v1/projects/${id}/detail`), (d) => {
+            const view = readPublishStatus(unwrapProject(d));
+            // Done when the latest committed build has been published and nothing is queued.
+            return view.lastPublishedCommit === commitId && view.unpublishedChanges === 0;
+        }, {
+            intervalMs: 3000,
+            timeoutMs,
+            onTick: (elapsed) => {
+                process.stderr.write(`\rWaiting... ${Math.round(elapsed / 1000)}s elapsed`);
+            },
+        });
+        process.stderr.write("\n");
+        const project = unwrapProject(result);
+        const view = readPublishStatus(project);
+        const publishUrl = String(project.publish_url ?? "");
+        const reachable = publishUrl ? await verifyUrlReachable(publishUrl) : false;
+        if (publishUrl && !reachable) {
+            console.error(`Warning: ${publishUrl} did not return 200 within retries. The publish completed server-side but the URL may still be propagating.`);
+        }
+        printMessage(`Published commit ${commitId.slice(0, 7)} at ${view.lastPublishedAt}. URL: ${publishUrl}${reachable ? " (200 OK)" : ""}`);
+        print(getFormat(cmd), { ...result, lifecycle_status: resolveLifecycleStatus(project) });
+    }
+    catch (err) {
+        if (err instanceof TimeoutError) {
+            console.error(`\nTimed out after ${opts.timeout}s. Publish may still be in progress.`);
+            console.error(`Run "proj urls ${id}" to check current status.`);
+            process.exit(1);
+        }
+        throw err;
+    }
+});
+// HEAD-first URL probe with a small wall-clock budget. Falls back to GET when
+// HEAD isn't allowed (some hosts return 405). Used by `proj publish` (after
+// publish completes) and `proj urls` (to determine the recommended URL).
+async function verifyUrlReachable(url, attempts = 3, perAttemptMs = 2000) {
+    for (let i = 0; i < attempts; i++) {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), perAttemptMs);
+        try {
+            let res = await fetch(url, { method: "HEAD", signal: ctrl.signal });
+            // Some hosts reject HEAD (405 / 501) — retry once with GET on this attempt.
+            if (res.status === 405 || res.status === 501) {
+                res = await fetch(url, { method: "GET", signal: ctrl.signal });
+            }
+            clearTimeout(t);
+            if (res.status === 200)
+                return true;
+        }
+        catch {
+            clearTimeout(t);
+        }
+        if (i < attempts - 1)
+            await new Promise((r) => setTimeout(r, 1000));
+    }
+    return false;
+}
+projectCmd
+    .command("publish-status <project_id>")
+    .description("Get publish status and URLs for a project")
+    .action(async (id, _opts, cmd) => {
+    const project = unwrapProject(await client.get(`/v1/projects/${id}/detail`));
+    const view = readPublishStatus(project);
+    const result = {
+        status: String(project.status ?? ""),
+        lifecycle_status: resolveLifecycleStatus(project),
+        published: view.isPublished,
+        unpublished_changes: view.unpublishedChanges,
+        last_published_commit_id: view.lastPublishedCommit || null,
+        last_published_at: view.lastPublishedAt || null,
+        publish_url: project.publish_url ?? null,
+        preview_url: project.preview_url ?? null,
+        publish_commit: project.publish_commit ?? null,
+        updated_at: project.updated_at ?? null,
+    };
+    print(getFormat(cmd), result);
+});
+projectCmd
+    .command("urls <project_id>")
+    .description("Get all URLs for a project with a recommended share URL")
+    .action(async (id, _opts, cmd) => {
+    const project = unwrapProject(await client.get(`/v1/projects/${id}/detail`));
+    const view = readPublishStatus(project);
+    const publishUrl = project.publish_url || "";
+    const previewUrl = project.preview_url || "";
+    const visibility = project.visibility ?? null;
+    const publishCandidate = publishUrl && Boolean(view.lastPublishedCommit);
+    // Probe both in parallel — independent network calls.
+    const [publishReachable, previewReachable] = await Promise.all([
+        publishCandidate ? verifyUrlReachable(publishUrl) : Promise.resolve(false),
+        previewUrl ? verifyUrlReachable(previewUrl) : Promise.resolve(false),
+    ]);
+    let recommended = null;
+    let environment = "none";
+    if (publishReachable) {
+        recommended = publishUrl;
+        environment = "production";
+    }
+    else if (previewReachable) {
+        recommended = previewUrl;
+        environment = "preview";
+    }
+    const result = {
+        preview_url: previewUrl || null,
+        preview_reachable: previewReachable,
+        publish_url: publishUrl || null,
+        publish_reachable: publishReachable,
+        last_published_commit_id: view.lastPublishedCommit || null,
+        last_published_at: view.lastPublishedAt || null,
+        recommended_share_url: recommended,
+        environment,
+        visibility,
+    };
+    print(getFormat(cmd), result);
+});
+projectCmd
+    .command("remix <project_id>")
+    .description("Remix a project")
+    .option("--workspace-id <id>", "Target workspace ID for remix")
+    .action(async (id, opts, cmd) => {
+    const body = {};
+    if (opts.workspaceId)
+        body.workspace_id = opts.workspaceId;
+    const data = await client.post(`/v1/projects/${id}/remix`, body);
+    print(getFormat(cmd), data);
+});
+projectCmd
+    .command("visibility <project_id> <public|private>")
+    .description("Update project visibility")
+    .action(async (id, visibility, _opts, cmd) => {
+    if (visibility !== "public" && visibility !== "private") {
+        throw new Error("Visibility must be 'public' or 'private'");
+    }
+    await client.post(`/v1/projects/${id}/update_visibility`, { visibility });
+    printResult(getFormat(cmd), { project_id: id, visibility }, `Project visibility set to ${visibility}.`);
+});
+projectCmd
+    .command("plan-mode <project_id> <enable|disable>")
+    .description("Enable or disable plan mode for a project")
+    .action(async (id, action, _opts, cmd) => {
+    if (action !== "enable" && action !== "disable") {
+        throw new Error("Action must be 'enable' or 'disable'");
+    }
+    const data = await client.post(`/v1/projects/${id}/plan-mode/${action}`);
+    const project = unwrapProject(data);
+    printResult(getFormat(cmd), project, `Plan mode ${action}d.`);
+});
+projectCmd
+    .command("source-code <project_id>")
+    .description("Get the full source code of a project")
+    .action(async (id, _opts, cmd) => {
+    const data = await client.get(`/v1/projects/${id}/source-code`);
+    print(getFormat(cmd), data);
+});
+projectCmd
+    .command("edit-file <project_id>")
+    .description("Directly edit source files in the project (creates a new turn)")
+    .requiredOption("--commit <id>", "Current commit ID (from proj get)")
+    .requiredOption("--path <file_path>", "File path to edit")
+    .requiredOption("--code <content>", "New file content")
+    .action(async (id, opts, cmd) => {
+    const data = await client.post(`/v1/projects/${id}/edit-code`, {
+        commit: opts.commit,
+        source_codes: [{ file_path: opts.path, code: opts.code }],
+    });
+    print(getFormat(cmd), data);
+});
+projectCmd
+    .command("model <project_id> <model>")
+    .description("Set the AI model for a project (takes effect on next turn)")
+    .action(async (id, model, _opts, cmd) => {
+    const data = await client.post(`/v1/projects/${id}/model`, { model });
+    print(getFormat(cmd), data);
+});
+// MCP subcommand group
+const mcpCmd = new Command("mcp").description("Manage MCP servers for a project");
+mcpCmd
+    .command("list <project_id>")
+    .description("List MCP servers")
+    .action(async (id, _opts, cmd) => {
+    const data = await client.get(`/v1/projects/${id}/mcp/servers`);
+    const resp = data;
+    const format = getFormat(cmd);
+    if (format !== "table") {
+        print(format, data);
+        return;
+    }
+    const rows = (resp.servers || []).map((s) => [
+        String(s.id ?? ""),
+        String(s.name ?? s.display_name ?? ""),
+        String(s.transport ?? ""),
+        String(s.enabled ?? ""),
+        String(s.url ?? ""),
+    ]);
+    printTable(["ID", "Name", "Transport", "Enabled", "URL"], rows);
+});
+mcpCmd
+    .command("get <project_id> <server_id>")
+    .description("Get an MCP server")
+    .action(async (id, serverId, _opts, cmd) => {
+    const data = await client.get(`/v1/projects/${id}/mcp/servers/${serverId}`);
+    print(getFormat(cmd), data);
+});
+mcpCmd
+    .command("create <project_id>")
+    .description("Add MCP server(s) to a project")
+    .requiredOption("--name <name>", "Server name (key in mcpServers map)")
+    .requiredOption("--url <url>", "Server URL")
+    .option("--transport <type>", "Transport type: sse, http, stdio")
+    .action(async (id, opts, cmd) => {
+    const serverConfig = { url: opts.url };
+    if (opts.transport)
+        serverConfig.transport = opts.transport;
+    const data = await client.post(`/v1/projects/${id}/mcp/servers`, {
+        mcpServers: { [opts.name]: serverConfig },
+    });
+    print(getFormat(cmd), data);
+});
+mcpCmd
+    .command("update <project_id> <server_id>")
+    .description("Update an MCP server")
+    .option("--display-name <name>", "New display name")
+    .option("--enabled <bool>", "Enable or disable (true/false)")
+    .option("--allowed-tools <tools>", "Comma-separated list of allowed tools")
+    .action(async (id, serverId, opts, cmd) => {
+    const body = {};
+    if (opts.displayName)
+        body.display_name = opts.displayName;
+    if (opts.enabled !== undefined)
+        body.enabled = opts.enabled === "true";
+    if (opts.allowedTools)
+        body.allowed_tools = opts.allowedTools.split(",").map((t) => t.trim());
+    const data = await client.patch(`/v1/projects/${id}/mcp/servers/${serverId}`, body);
+    print(getFormat(cmd), data ?? { message: "MCP server updated." });
+});
+mcpCmd
+    .command("delete <project_id> <server_id>")
+    .description("Delete an MCP server")
+    .action(async (id, serverId) => {
+    await client.del(`/v1/projects/${id}/mcp/servers/${serverId}`);
+    printMessage(`MCP server ${serverId} deleted.`);
+});
+projectCmd.addCommand(mcpCmd);
+// Project skills subcommand group
+const projSkillsCmd = new Command("skills").description("Manage project skills");
+projSkillsCmd
+    .command("list <project_id>")
+    .description("List skills installed on a project")
+    .action(async (id, _opts, cmd) => {
+    const data = await client.get(`/v1/projects/${id}/skills`);
+    const resp = data;
+    const format = getFormat(cmd);
+    if (format !== "table") {
+        print(format, data);
+        return;
+    }
+    const rows = (resp.skills || []).map((s) => [
+        String(s.skill_key ?? ""),
+        String(s.name ?? ""),
+        String(s.type ?? ""),
+        String(s.state ?? ""),
+        String(s.version ?? ""),
+    ]);
+    printTable(["Key", "Name", "Type", "State", "Version"], rows);
+});
+projSkillsCmd
+    .command("update <project_id>")
+    .description("Enable or disable a project skill")
+    .requiredOption("--skill-key <key>", "Skill key")
+    .requiredOption("--enabled <bool>", "true to enable, false to disable")
+    .action(async (id, opts, cmd) => {
+    const data = await client.patch(`/v1/projects/${id}/skills`, {
+        updates: [{ skill_key: opts.skillKey, enabled: opts.enabled === "true" }],
+    });
+    print(getFormat(cmd), data);
+});
+projectCmd.addCommand(projSkillsCmd);

package/dist/commands/project.js.map

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

package/dist/commands/skill.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const skillCmd: Command;

package/dist/commands/skill.js

@@ -0,0 +1,118 @@
+import { Command } from "commander";
+import * as client from "../client.js";
+import { print, printMessage, printTable, pickList } from "../output.js";
+export const skillCmd = new Command("skill").description("Manage skills and agent skill installations");
+function getFormat(cmd) {
+    return cmd.optsWithGlobals().output || "json";
+}
+skillCmd
+    .command("list")
+    .description("List available skills")
+    .option("--role <role>", "Filter by minimum role: owner, admin, developer, viewer")
+    .action(async (opts, cmd) => {
+    const params = {};
+    if (opts.role)
+        params.role = opts.role;
+    const data = await client.workGet("/v1/skills", params);
+    const resp = data;
+    const items = pickList(resp.skills || [], [
+        "slug", "name", "description", "is_public", "latest_version", "published_version", "role",
+    ]);
+    const format = getFormat(cmd);
+    if (format !== "table") {
+        print(format, { items, total: items.length });
+        return;
+    }
+    const rows = items.map((s) => [
+        String(s.slug ?? ""),
+        String(s.name ?? ""),
+        String(s.is_public ?? ""),
+        String(s.published_version ?? ""),
+        String(s.role ?? ""),
+    ]);
+    printTable(["Slug", "Name", "Public", "Version", "Role"], rows);
+});
+skillCmd
+    .command("search <keyword>")
+    .description("Search skills by keyword")
+    .action(async (keyword, _opts, cmd) => {
+    const data = await client.workGet("/v1/skills/search", { keyword });
+    const resp = data;
+    const items = pickList(resp.skills || [], [
+        "slug", "name", "description", "is_public", "published_version", "role",
+    ]);
+    const format = getFormat(cmd);
+    if (format !== "table") {
+        print(format, { items, total: items.length });
+        return;
+    }
+    const rows = items.map((s) => [
+        String(s.slug ?? ""),
+        String(s.name ?? ""),
+        String(s.is_public ?? ""),
+        String(s.published_version ?? ""),
+    ]);
+    printTable(["Slug", "Name", "Public", "Version"], rows);
+});
+skillCmd
+    .command("get <slug>")
+    .description("Get skill details")
+    .action(async (slug, _opts, cmd) => {
+    const data = await client.workGet(`/v1/skills/${slug}`);
+    print(getFormat(cmd), data);
+});
+skillCmd
+    .command("delete <slug>")
+    .description("Delete a skill")
+    .action(async (slug) => {
+    await client.workDel(`/v1/skills/${slug}`);
+    printMessage(`Skill "${slug}" deleted.`);
+});
+skillCmd
+    .command("visibility <slug> <public|private>")
+    .description("Set skill visibility")
+    .action(async (slug, visibility) => {
+    if (visibility !== "public" && visibility !== "private") {
+        throw new Error("Visibility must be 'public' or 'private'");
+    }
+    await client.workPatch(`/v1/skills/${slug}/visibility`, {
+        is_public: visibility === "public",
+    });
+    printMessage(`Skill "${slug}" visibility set to ${visibility}.`);
+});
+skillCmd
+    .command("install <slug>")
+    .description("Install a skill to an agent")
+    .requiredOption("--agent <name>", "Agent name to install the skill to")
+    .option("--version <n>", "Skill version to install (default: latest published)")
+    .action(async (slug, opts, cmd) => {
+    const body = { agent_name: opts.agent };
+    if (opts.version)
+        body.version = parseInt(opts.version, 10);
+    const data = await client.workPost(`/v1/skills/${slug}/install`, body);
+    print(getFormat(cmd), data ?? { message: "Skill installed successfully." });
+});
+skillCmd
+    .command("uninstall")
+    .description("Uninstall a skill from an agent")
+    .requiredOption("--agent <name>", "Agent name")
+    .requiredOption("--skill <name>", "Skill directory name (from 'skill agents' output)")
+    .action(async (opts) => {
+    await client.workDel(`/v1/user/agents/${opts.agent}/skills/${opts.skill}`);
+    printMessage(`Skill "${opts.skill}" uninstalled from agent "${opts.agent}".`);
+});
+skillCmd
+    .command("agents")
+    .description("List skills installed on agents")
+    .option("--agent <name>", "Show skills for a specific agent only")
+    .action(async (opts, cmd) => {
+    const format = getFormat(cmd);
+    if (opts.agent) {
+        const data = await client.workGet(`/v1/user/agents/${opts.agent}/skills`);
+        print(format, data);
+    }
+    else {
+        const data = await client.workGet("/v1/user/agents/skills");
+        print(format, data);
+    }
+});

package/dist/commands/thread.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const threadCmd: Command;