@solcreek/cli 0.3.4 → 0.3.5

package/dist/commands/claim.js

@@ -2,7 +2,7 @@ import { defineCommand } from "citty";
 import consola from "consola";
 import { CreekClient } from "@solcreek/sdk";
 import { getToken, getApiUrl, getSandboxApiUrl } from "../utils/config.js";
-import { globalArgs, resolveJsonMode, jsonOutput } from "../utils/output.js";
+import { globalArgs, resolveJsonMode, jsonOutput, AUTH_BREADCRUMBS } from "../utils/output.js";
 export const claimCommand = defineCommand({
     meta: {
         name: "claim",
@@ -21,7 +21,7 @@ export const claimCommand = defineCommand({
         const token = getToken();
         if (!token) {
             if (jsonMode)
-                jsonOutput({ ok: false, error: "not_authenticated", message: "Run `creek login` first" }, 1);
+                jsonOutput({ ok: false, error: "not_authenticated", message: "Run `creek login` first" }, 1, AUTH_BREADCRUMBS);
             consola.error("You need to be logged in to claim a sandbox.");
             consola.info("Run `creek login` first, then `creek claim` again.");
             process.exit(1);
@@ -41,7 +41,9 @@ export const claimCommand = defineCommand({
                 ? "This sandbox has expired and can no longer be claimed."
                 : `Sandbox is in '${sandbox.status}' state and cannot be claimed.`;
             if (jsonMode)
-                jsonOutput({ ok: false, error: "not_claimable", status: sandbox.status, message: msg }, 1);
+                jsonOutput({ ok: false, error: "not_claimable", status: sandbox.status, message: msg }, 1, [
+                    { command: "creek deploy", description: "Deploy your project permanently" },
+                ]);
             consola.error(msg);
             if (sandbox.status === "expired")
                 consola.info("Run `creek deploy` to deploy your project permanently.");
@@ -80,7 +82,10 @@ export const claimCommand = defineCommand({
             // Best effort — claim status update is non-critical
         }
         if (jsonMode) {
-            jsonOutput({ ok: true, sandboxId, project: project.slug, projectId: project.id });
+            jsonOutput({ ok: true, sandboxId, project: project.slug, projectId: project.id }, 0, [
+                { command: "creek init", description: "Initialize creek.toml for local development" },
+                { command: "creek deploy", description: "Deploy permanently" },
+            ]);
         }
         consola.success("Sandbox claimed!");
         consola.info("");

package/dist/commands/deploy.js

@@ -9,7 +9,7 @@ import { collectAssets } from "../utils/bundle.js";
 import { bundleSSRServer } from "../utils/ssr-bundle.js";
 import { bundleWorker } from "../utils/worker-bundle.js";
 import { sandboxDeploy, pollSandboxStatus, printSandboxSuccess } from "../utils/sandbox.js";
-import { isTTY, jsonOutput, resolveJsonMode, globalArgs, shouldAutoConfirm } from "../utils/output.js";
+import { isTTY, jsonOutput, resolveJsonMode, globalArgs, shouldAutoConfirm, NO_PROJECT_BREADCRUMBS } from "../utils/output.js";
 import { ensureTosAccepted } from "../utils/tos.js";
 import { buildNextjs, patchBundledWorker, hasAdapterOutput } from "../utils/nextjs.js";
 import { isRepoUrl, parseRepoUrl, validateRepoUrl, validateSubpath, RepoUrlError } from "../utils/repo-url.js";
@@ -90,7 +90,7 @@ export const deployCommand = defineCommand({
         if (args.dir) {
             if (!existsSync(cwd)) {
                 if (jsonMode)
-                    jsonOutput({ error: "not_found", message: `Directory not found: ${args.dir}` }, 1);
+                    jsonOutput({ error: "not_found", message: `Directory not found: ${args.dir}` }, 1, NO_PROJECT_BREADCRUMBS);
                 consola.error(`Directory not found: ${args.dir}`);
                 process.exit(1);
             }
@@ -128,7 +128,7 @@ export const deployCommand = defineCommand({
         }
         // --- Nothing found → guide the user ---
         if (jsonMode)
-            jsonOutput({ error: "no_project", message: "No project found in this directory" }, 1);
+            jsonOutput({ error: "no_project", message: "No project found in this directory" }, 1, NO_PROJECT_BREADCRUMBS);
         consola.info("No project found in this directory.\n");
         consola.info("  creek deploy ./dist        Deploy a build output directory");
         consola.info("  creek deploy --demo        Deploy a sample site (see Creek in 5 seconds)");
@@ -198,7 +198,9 @@ async function deployRepoUrl(input, options) {
     catch (err) {
         if (err instanceof RepoUrlError || err instanceof GitCloneError) {
             if (jsonMode)
-                jsonOutput({ error: "repo_deploy_failed", message: err.message }, 1);
+                jsonOutput({ error: "repo_deploy_failed", message: err.message }, 1, [
+                    { command: "creek deploy --demo", description: "Deploy a sample site instead" },
+                ]);
             consola.error(err.message);
             process.exit(1);
         }
@@ -260,12 +262,15 @@ async function deployDemo(jsonMode) {
                 deployDurationMs: status.deployDurationMs,
                 expiresAt: result.expiresAt,
                 mode: "demo",
-            });
+            }, 0, [
+                { command: `creek status ${result.sandboxId}`, description: "Check sandbox status" },
+                { command: `creek claim ${result.sandboxId}`, description: "Claim as permanent project" },
+            ]);
         }
         const duration = status.deployDurationMs
             ? `in ${(status.deployDurationMs / 1000).toFixed(1)}s`
             : "in seconds";
-        consola.success(`Live ${duration} → ${status.previewUrl}`);
+        consola.success(`⬡ Live ${duration} → ${status.previewUrl}`);
         consola.info("");
         consola.info("That's Creek. Now deploy your own project:");
         consola.info("  cd your-project && npx creek deploy");
@@ -273,7 +278,9 @@ async function deployDemo(jsonMode) {
     catch (err) {
         const message = err instanceof Error ? err.message : "Demo deploy failed";
         if (jsonMode)
-            jsonOutput({ ok: false, error: "deploy_failed", message }, 1);
+            jsonOutput({ ok: false, error: "deploy_failed", message }, 1, [
+                { command: "creek deploy --demo", description: "Retry demo deploy" },
+            ]);
         consola.error(message);
         process.exit(1);
     }
@@ -287,7 +294,7 @@ async function deployDirectory(dir, jsonMode, tos) {
     const { assets, fileList } = collectAssets(dir);
     if (fileList.length === 0) {
         if (jsonMode)
-            jsonOutput({ ok: false, error: "no_files", message: `No files found in ${dir}` }, 1);
+            jsonOutput({ ok: false, error: "no_files", message: `No files found in ${dir}` }, 1, NO_PROJECT_BREADCRUMBS);
         consola.error(`No files found in ${dir}\n`);
         consola.info("  creek deploy ./dist        Deploy a build output directory");
         consola.info("  creek deploy --demo        Deploy a sample site (see Creek in 5 seconds)");
@@ -311,14 +318,19 @@ async function deployDirectory(dir, jsonMode, tos) {
                 expiresAt: result.expiresAt,
                 assetCount: fileList.length,
                 mode: "sandbox",
-            });
+            }, 0, [
+                { command: `creek status ${result.sandboxId}`, description: "Check sandbox status" },
+                { command: `creek claim ${result.sandboxId}`, description: "Claim as permanent project" },
+            ]);
         }
         printSandboxSuccess(status.previewUrl, result.expiresAt, result.sandboxId);
     }
     catch (err) {
         const message = err instanceof Error ? err.message : "Deploy failed";
         if (jsonMode)
-            jsonOutput({ ok: false, error: "deploy_failed", message }, 1);
+            jsonOutput({ ok: false, error: "deploy_failed", message }, 1, [
+                { command: "creek deploy", description: "Retry deploy" },
+            ]);
         consola.error(message);
         process.exit(1);
     }
@@ -438,14 +450,19 @@ async function deploySandbox(cwd, skipBuild, jsonMode = false, resolved, tos) {
                 framework: framework ?? null,
                 assetCount: fileList.length,
                 mode: "sandbox",
-            });
+            }, 0, [
+                { command: `creek status ${result.sandboxId}`, description: "Check sandbox status" },
+                { command: `creek claim ${result.sandboxId}`, description: "Claim as permanent project" },
+            ]);
         }
         printSandboxSuccess(status.previewUrl, result.expiresAt, result.sandboxId);
     }
     catch (err) {
         const message = err instanceof Error ? err.message : "Sandbox deploy failed";
         if (jsonMode)
-            jsonOutput({ ok: false, error: "deploy_failed", message }, 1);
+            jsonOutput({ ok: false, error: "deploy_failed", message }, 1, [
+                { command: "creek deploy", description: "Retry deploy" },
+            ]);
         consola.error(message);
         process.exit(1);
     }
@@ -787,9 +804,13 @@ async function deployAuthenticated(cwd, resolved, token, skipBuild, jsonMode = f
                         deploymentId: deployment.id,
                         project: project.slug,
                         mode: "production",
-                    });
+                    }, 0, [
+                        { command: `creek status`, description: "Check deployment status" },
+                        { command: `creek deployments --project ${project.slug}`, description: "View deployment history" },
+                        { command: `creek domains add <HOSTNAME> --project ${project.slug}`, description: "Add custom domain" },
+                    ]);
                 }
-                consola.success(`  Deployed! ${res.url ?? res.previewUrl}`);
+                consola.success(`  ⬡ Deployed! ${res.url ?? res.previewUrl}`);
                 if (res.url && res.previewUrl) {
                     consola.info(`  Preview: ${res.previewUrl}`);
                 }
@@ -799,20 +820,28 @@ async function deployAuthenticated(cwd, resolved, token, skipBuild, jsonMode = f
                 const step = failed_step ? ` at ${failed_step}` : "";
                 const msg = error_message ?? "Unknown error";
                 if (jsonMode)
-                    jsonOutput({ ok: false, error: "deploy_failed", message: msg, failedStep: failed_step }, 1);
+                    jsonOutput({ ok: false, error: "deploy_failed", message: msg, failedStep: failed_step }, 1, [
+                        { command: `creek deployments --project ${project.slug}`, description: "Check previous deployments" },
+                        { command: `creek rollback --project ${project.slug}`, description: "Rollback to previous version" },
+                    ]);
                 consola.error(`Deploy failed${step}: ${msg}`);
                 process.exit(1);
             }
             if (status === "cancelled") {
                 if (jsonMode)
-                    jsonOutput({ ok: false, error: "cancelled", message: "Deploy was cancelled" }, 1);
+                    jsonOutput({ ok: false, error: "cancelled", message: "Deploy was cancelled" }, 1, [
+                        { command: "creek deploy", description: "Retry deploy" },
+                    ]);
                 consola.warn("Deploy was cancelled");
                 process.exit(1);
             }
             await new Promise((r) => setTimeout(r, POLL_INTERVAL));
         }
         if (jsonMode)
-            jsonOutput({ ok: false, error: "timeout", message: "Deploy timed out after 2 minutes" }, 1);
+            jsonOutput({ ok: false, error: "timeout", message: "Deploy timed out after 2 minutes" }, 1, [
+                { command: `creek status`, description: "Check if deploy completed" },
+                { command: "creek deploy", description: "Retry deploy" },
+            ]);
         consola.error("Deploy timed out after 2 minutes");
         process.exit(1);
     }

package/dist/commands/deployments.js

@@ -5,7 +5,7 @@ import { getToken, getApiUrl } from "../utils/config.js";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { parseConfig } from "@solcreek/sdk";
-import { globalArgs, resolveJsonMode, jsonOutput } from "../utils/output.js";
+import { globalArgs, resolveJsonMode, jsonOutput, AUTH_BREADCRUMBS, NO_PROJECT_BREADCRUMBS } from "../utils/output.js";
 export const deploymentsCommand = defineCommand({
     meta: {
         name: "deployments",
@@ -24,7 +24,7 @@ export const deploymentsCommand = defineCommand({
         const token = getToken();
         if (!token) {
             if (jsonMode)
-                jsonOutput({ ok: false, error: "not_authenticated" }, 1);
+                jsonOutput({ ok: false, error: "not_authenticated" }, 1, AUTH_BREADCRUMBS);
             consola.error("Not authenticated. Run `creek login` first.");
             process.exit(1);
         }
@@ -34,7 +34,7 @@ export const deploymentsCommand = defineCommand({
             const configPath = join(process.cwd(), "creek.toml");
             if (!existsSync(configPath)) {
                 if (jsonMode)
-                    jsonOutput({ ok: false, error: "no_project", message: "No creek.toml found. Use --project <slug> or run from a project directory." }, 1);
+                    jsonOutput({ ok: false, error: "no_project", message: "No creek.toml found. Use --project <slug> or run from a project directory." }, 1, NO_PROJECT_BREADCRUMBS);
                 consola.error("No creek.toml found. Use --project <slug> or run from a project directory.");
                 process.exit(1);
             }
@@ -53,7 +53,13 @@ export const deploymentsCommand = defineCommand({
             process.exit(1);
         }
         if (jsonMode) {
-            jsonOutput({ ok: true, project: slug, deployments });
+            const crumbs = deployments.length > 0
+                ? [
+                    { command: `creek rollback --project ${slug}`, description: "Rollback to previous deployment" },
+                    { command: `creek status`, description: "Check current project status" },
+                ]
+                : [{ command: `creek deploy`, description: "Create first deployment" }];
+            jsonOutput({ ok: true, project: slug, deployments }, 0, crumbs);
         }
         if (deployments.length === 0) {
             consola.info(`No deployments for ${slug}. Run \`creek deploy\` to create one.`);

package/dist/commands/domains.js

@@ -38,7 +38,9 @@ const domainsLs = defineCommand({
         const slug = getProjectSlug(args);
         const domains = await client.listDomains(slug);
         if (jsonMode) {
-            jsonOutput({ ok: true, project: slug, domains });
+            jsonOutput({ ok: true, project: slug, domains }, 0, [
+                { command: `creek domains add <HOSTNAME> --project ${slug}`, description: "Add a custom domain" },
+            ]);
             return;
         }
         if (domains.length === 0) {
@@ -67,7 +69,13 @@ const domainsAdd = defineCommand({
         const result = await client.addDomain(slug, args.hostname);
         const { domain, verification } = result;
         if (jsonMode) {
-            jsonOutput({ ok: true, project: slug, domain, verification });
+            const crumbs = domain.status === "active"
+                ? [{ command: `creek domains ls --project ${slug}`, description: "List all domains" }]
+                : [
+                    { command: `creek domains ls --project ${slug}`, description: "Check domain status" },
+                    { command: `creek domains activate ${domain.hostname} --project ${slug}`, description: "Activate after DNS setup" },
+                ];
+            jsonOutput({ ok: true, project: slug, domain, verification }, 0, crumbs);
             return;
         }
         if (domain.status === "active") {
@@ -108,7 +116,9 @@ const domainsRm = defineCommand({
         }
         await client.deleteDomain(slug, domain.id);
         if (jsonMode) {
-            jsonOutput({ ok: true, hostname: domain.hostname, removed: true, project: slug });
+            jsonOutput({ ok: true, hostname: domain.hostname, removed: true, project: slug }, 0, [
+                { command: `creek domains ls --project ${slug}`, description: "List remaining domains" },
+            ]);
             return;
         }
         consola.success(`Removed ${domain.hostname}`);
@@ -138,7 +148,9 @@ const domainsActivate = defineCommand({
         }
         await client.activateDomain(slug, domain.id);
         if (jsonMode) {
-            jsonOutput({ ok: true, hostname: domain.hostname, status: "active", project: slug });
+            jsonOutput({ ok: true, hostname: domain.hostname, status: "active", project: slug }, 0, [
+                { command: `creek domains ls --project ${slug}`, description: "List all domains" },
+            ]);
             return;
         }
         consola.success(`Activated ${domain.hostname}`);

package/dist/commands/env.js

@@ -34,7 +34,10 @@ const envSet = defineCommand({
         const slug = getProjectSlug();
         await client.setEnvVar(slug, args.key, args.value);
         if (jsonMode)
-            jsonOutput({ ok: true, key: args.key, project: slug });
+            jsonOutput({ ok: true, key: args.key, project: slug }, 0, [
+                { command: `creek env ls --project ${slug}`, description: "List all environment variables" },
+                { command: `creek deploy`, description: "Deploy to apply changes" },
+            ]);
         consola.success(`Set ${args.key}`);
     },
 });
@@ -55,11 +58,18 @@ const envGet = defineCommand({
         const slug = getProjectSlug();
         const vars = await client.listEnvVars(slug);
         if (jsonMode) {
+            const crumbs = [
+                { command: `creek env set <KEY> <VALUE>`, description: "Set an environment variable" },
+            ];
+            if (vars.length > 0) {
+                crumbs.push({ command: `creek env rm ${vars[0].key}`, description: `Remove ${vars[0].key}` });
+            }
+            crumbs.push({ command: "creek deploy", description: "Deploy to apply changes" });
             jsonOutput({
                 ok: true,
                 project: slug,
                 vars: vars.map((v) => ({ key: v.key, value: args.show ? v.value : redact(v.value) })),
-            });
+            }, 0, crumbs);
         }
         if (vars.length === 0) {
             consola.info("No environment variables set.");
@@ -86,7 +96,10 @@ const envRm = defineCommand({
         const slug = getProjectSlug();
         await client.deleteEnvVar(slug, args.key);
         if (jsonMode)
-            jsonOutput({ ok: true, key: args.key, removed: true, project: slug });
+            jsonOutput({ ok: true, key: args.key, removed: true, project: slug }, 0, [
+                { command: `creek env ls --project ${slug}`, description: "List remaining variables" },
+                { command: "creek deploy", description: "Deploy to apply changes" },
+            ]);
         consola.success(`Removed ${args.key}`);
     },
 });

package/dist/commands/init.js

@@ -61,7 +61,11 @@ export const initCommand = defineCommand({
         };
         writeFileSync(configPath, stringify(config));
         if (jsonMode) {
-            jsonOutput({ ok: true, name, framework: framework ?? null, path: configPath });
+            jsonOutput({ ok: true, name, framework: framework ?? null, path: configPath }, 0, [
+                { command: "creek deploy", description: "Deploy the project" },
+                { command: "creek env set <KEY> <VALUE>", description: "Set an environment variable" },
+                { command: "creek dev", description: "Start local development server" },
+            ]);
         }
         consola.success(`Created creek.toml for "${name}"`);
     },

package/dist/commands/login.js

@@ -106,14 +106,21 @@ async function saveAndVerify(apiKey, jsonMode = false) {
     const session = await client.getSession();
     if (!session?.user) {
         if (jsonMode)
-            jsonOutput({ ok: false, error: "invalid_token", message: "Invalid API key" }, 1);
+            jsonOutput({ ok: false, error: "invalid_token", message: "Invalid API key" }, 1, [
+                { command: "creek login", description: "Try interactive login" },
+                { command: "creek login --headless", description: "Paste API key manually" },
+            ]);
         consola.error("Invalid API key. Please check and try again.");
         process.exit(1);
     }
     const config = readCliConfig();
     writeCliConfig({ ...config, token: apiKey });
     if (jsonMode) {
-        jsonOutput({ ok: true, user: session.user.name, email: session.user.email });
+        jsonOutput({ ok: true, user: session.user.name, email: session.user.email }, 0, [
+            { command: "creek projects", description: "List your projects" },
+            { command: "creek deploy", description: "Deploy current directory" },
+            { command: "creek whoami", description: "Verify authenticated user" },
+        ]);
     }
     consola.success(`Logged in as ${session.user.name} (${session.user.email})`);
 }

package/dist/commands/projects.js

@@ -2,7 +2,7 @@ import { defineCommand } from "citty";
 import consola from "consola";
 import { CreekClient } from "@solcreek/sdk";
 import { getToken, getApiUrl } from "../utils/config.js";
-import { globalArgs, resolveJsonMode, jsonOutput } from "../utils/output.js";
+import { globalArgs, resolveJsonMode, jsonOutput, AUTH_BREADCRUMBS } from "../utils/output.js";
 export const projectsCommand = defineCommand({
     meta: {
         name: "projects",
@@ -14,14 +14,20 @@ export const projectsCommand = defineCommand({
         const token = getToken();
         if (!token) {
             if (jsonMode)
-                jsonOutput({ ok: false, error: "not_authenticated" }, 1);
+                jsonOutput({ ok: false, error: "not_authenticated" }, 1, AUTH_BREADCRUMBS);
             consola.error("Not authenticated. Run `creek login` first.");
             process.exit(1);
         }
         const client = new CreekClient(getApiUrl(), token);
         const projects = await client.listProjects();
         if (jsonMode) {
-            jsonOutput({ ok: true, projects });
+            const crumbs = projects.length > 0
+                ? projects.slice(0, 3).map((p) => ({
+                    command: `creek deployments --project ${p.slug}`,
+                    description: `List deployments for ${p.slug}`,
+                }))
+                : [{ command: "creek deploy", description: "Deploy your first project" }];
+            jsonOutput({ ok: true, projects }, 0, crumbs);
         }
         if (projects.length === 0) {
             consola.info("No projects yet. Deploy one with `creek deploy`.");

package/dist/commands/rollback.d.ts

@@ -0,0 +1,27 @@
+export declare const rollbackCommand: import("citty").CommandDef<{
+    json: {
+        type: "boolean";
+        description: string;
+        default: boolean;
+    };
+    yes: {
+        type: "boolean";
+        description: string;
+        default: boolean;
+    };
+    deployment: {
+        type: "positional";
+        description: string;
+        required: false;
+    };
+    message: {
+        type: "string";
+        alias: string;
+        description: string;
+    };
+    project: {
+        type: "string";
+        description: string;
+    };
+}>;
+//# sourceMappingURL=rollback.d.ts.map

package/dist/commands/rollback.js

@@ -0,0 +1,82 @@
+import { defineCommand } from "citty";
+import consola from "consola";
+import { CreekClient, parseConfig } from "@solcreek/sdk";
+import { getToken, getApiUrl } from "../utils/config.js";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { globalArgs, resolveJsonMode, jsonOutput, AUTH_BREADCRUMBS } from "../utils/output.js";
+function getProjectSlug(args) {
+    if (args?.project)
+        return args.project;
+    const configPath = join(process.cwd(), "creek.toml");
+    if (!existsSync(configPath)) {
+        consola.error("No creek.toml found. Use --project <slug> or run from a project directory.");
+        process.exit(1);
+    }
+    return parseConfig(readFileSync(configPath, "utf-8")).project.name;
+}
+export const rollbackCommand = defineCommand({
+    meta: {
+        name: "rollback",
+        description: "Rollback production to a previous deployment",
+    },
+    args: {
+        deployment: {
+            type: "positional",
+            description: "Deployment ID to rollback to (default: previous)",
+            required: false,
+        },
+        message: {
+            type: "string",
+            alias: "m",
+            description: "Rollback reason (stored in audit log)",
+        },
+        project: {
+            type: "string",
+            description: "Project slug (default: from creek.toml)",
+        },
+        ...globalArgs,
+    },
+    async run({ args }) {
+        const jsonMode = resolveJsonMode(args);
+        const token = getToken();
+        if (!token) {
+            if (jsonMode)
+                jsonOutput({ ok: false, error: "not_authenticated", message: "Not authenticated" }, 1, AUTH_BREADCRUMBS);
+            consola.error("Not authenticated. Run `creek login` first.");
+            process.exit(1);
+        }
+        const projectSlug = getProjectSlug(args);
+        const client = new CreekClient(getApiUrl(), token);
+        const deploymentId = args.deployment;
+        const message = args.message;
+        try {
+            const result = await client.rollback(projectSlug, {
+                deploymentId: deploymentId || undefined,
+                message: message || undefined,
+            });
+            if (jsonMode) {
+                jsonOutput(result, 0, [
+                    { command: `creek status`, description: "Verify rollback status" },
+                    { command: `creek deployments --project ${projectSlug}`, description: "View deployment history" },
+                ]);
+                return;
+            }
+            consola.success(`⬡ Rolled back to deployment ${result.rolledBackTo.slice(0, 8)}`);
+            consola.info(`Production URL: ${result.url}`);
+            if (message) {
+                consola.info(`Reason: ${message}`);
+            }
+        }
+        catch (err) {
+            const msg = err.message ?? "Rollback failed";
+            if (jsonMode)
+                jsonOutput({ ok: false, error: "rollback_failed", message: msg }, 1, [
+                    { command: `creek deployments --project ${projectSlug}`, description: "List available deployments" },
+                ]);
+            consola.error(msg);
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=rollback.js.map

package/dist/commands/status.js

@@ -5,7 +5,7 @@ import { getToken, getApiUrl, getSandboxApiUrl } from "../utils/config.js";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { parseConfig } from "@solcreek/sdk";
-import { globalArgs, resolveJsonMode, jsonOutput } from "../utils/output.js";
+import { globalArgs, resolveJsonMode, jsonOutput, AUTH_BREADCRUMBS, NO_PROJECT_BREADCRUMBS } from "../utils/output.js";
 export const statusCommand = defineCommand({
     meta: {
         name: "status",
@@ -34,13 +34,18 @@ async function sandboxStatus(sandboxId, jsonMode) {
     const res = await fetch(`${sandboxApiUrl}/api/sandbox/${sandboxId}/status`);
     if (!res.ok) {
         if (jsonMode)
-            jsonOutput({ ok: false, error: "not_found", message: "Sandbox not found" }, 1);
+            jsonOutput({ ok: false, error: "not_found", message: "Sandbox not found" }, 1, [
+                { command: "creek deploy --demo", description: "Deploy a new sandbox" },
+            ]);
         consola.error("Sandbox not found. It may have expired.");
         process.exit(1);
     }
     const status = await res.json();
     if (jsonMode) {
-        jsonOutput({ ok: true, type: "sandbox", ...status });
+        const crumbs = status.claimable
+            ? [{ command: `creek claim ${sandboxId}`, description: "Claim as permanent project" }]
+            : [{ command: "creek deploy", description: "Deploy a new version" }];
+        jsonOutput({ ok: true, type: "sandbox", ...status }, 0, crumbs);
     }
     const s = status.status;
     const statusColor = s === "active" ? `\x1b[32m${s}\x1b[0m`
@@ -68,7 +73,7 @@ async function projectStatus(jsonMode) {
     const token = getToken();
     if (!token) {
         if (jsonMode)
-            jsonOutput({ ok: false, error: "not_authenticated" }, 1);
+            jsonOutput({ ok: false, error: "not_authenticated" }, 1, AUTH_BREADCRUMBS);
         consola.error("Not authenticated. Run `creek login` first.");
         consola.info("To check a sandbox: creek status <sandboxId>");
         process.exit(1);
@@ -76,7 +81,7 @@ async function projectStatus(jsonMode) {
     const configPath = join(process.cwd(), "creek.toml");
     if (!existsSync(configPath)) {
         if (jsonMode)
-            jsonOutput({ ok: false, error: "no_project", message: "No creek.toml found" }, 1);
+            jsonOutput({ ok: false, error: "no_project", message: "No creek.toml found" }, 1, NO_PROJECT_BREADCRUMBS);
         consola.error("No creek.toml found.");
         consola.info("To check a sandbox: creek status <sandboxId>");
         process.exit(1);
@@ -89,7 +94,10 @@ async function projectStatus(jsonMode) {
     }
     catch {
         if (jsonMode)
-            jsonOutput({ ok: false, error: "not_found", message: `Project "${config.project.name}" not found` }, 1);
+            jsonOutput({ ok: false, error: "not_found", message: `Project "${config.project.name}" not found` }, 1, [
+                { command: "creek deploy", description: "Deploy to create the project" },
+                { command: "creek projects", description: "List existing projects" },
+            ]);
         consola.error(`Project "${config.project.name}" not found.`);
         process.exit(1);
     }
@@ -101,7 +109,10 @@ async function projectStatus(jsonMode) {
             framework: project.framework,
             productionDeploymentId: project.production_deployment_id,
             createdAt: project.created_at,
-        });
+        }, 0, [
+            { command: `creek deployments --project ${project.slug}`, description: "List deployment history" },
+            { command: "creek deploy", description: "Deploy a new version" },
+        ]);
     }
     const deployed = project.production_deployment_id ? "deployed" : "not deployed";
     const framework = project.framework ? ` (${project.framework})` : "";

package/dist/commands/whoami.js

@@ -2,7 +2,7 @@ import { defineCommand } from "citty";
 import consola from "consola";
 import { CreekClient } from "@solcreek/sdk";
 import { getToken, getApiUrl } from "../utils/config.js";
-import { globalArgs, resolveJsonMode, jsonOutput } from "../utils/output.js";
+import { globalArgs, resolveJsonMode, jsonOutput, AUTH_BREADCRUMBS } from "../utils/output.js";
 export const whoamiCommand = defineCommand({
     meta: {
         name: "whoami",
@@ -14,7 +14,7 @@ export const whoamiCommand = defineCommand({
         const token = getToken();
         if (!token) {
             if (jsonMode)
-                jsonOutput({ ok: false, authenticated: false, error: "not_authenticated" }, 1);
+                jsonOutput({ ok: false, authenticated: false, error: "not_authenticated" }, 1, AUTH_BREADCRUMBS);
             consola.error("Not authenticated. Run `creek login` first.");
             process.exit(1);
         }
@@ -22,7 +22,7 @@ export const whoamiCommand = defineCommand({
         const session = await client.getSession();
         if (!session?.user) {
             if (jsonMode)
-                jsonOutput({ ok: false, authenticated: false, error: "session_expired" }, 1);
+                jsonOutput({ ok: false, authenticated: false, error: "session_expired" }, 1, AUTH_BREADCRUMBS);
             consola.error("Session expired or invalid. Run `creek login` to re-authenticate.");
             process.exit(1);
         }
@@ -33,7 +33,10 @@ export const whoamiCommand = defineCommand({
                 user: session.user.name,
                 email: session.user.email,
                 api: getApiUrl(),
-            });
+            }, 0, [
+                { command: "creek projects", description: "List your projects" },
+                { command: "creek deploy", description: "Deploy current directory" },
+            ]);
         }
         consola.log(`  User:  ${session.user.name}`);
         consola.log(`  Email: ${session.user.email}`);

package/dist/dev/server.js

@@ -110,7 +110,7 @@ export class DevServer {
             .map((b) => b.type.toUpperCase());
         const bindingStr = bindings.length > 0 ? ` (${bindings.join(", ")})` : "";
         console.log("");
-        consola.success(`creek dev\n`);
+        consola.success(`⬡ creek dev\n`);
         consola.info(`App:       http://localhost:${actualPort}`);
         if (config.workerEntry) {
             consola.info(`Worker:    ${config.workerEntry}${bindingStr}`);

package/dist/index.js

@@ -15,6 +15,7 @@ import { projectsCommand } from "./commands/projects.js";
 import { deploymentsCommand } from "./commands/deployments.js";
 import { statusCommand } from "./commands/status.js";
 import { devCommand } from "./commands/dev.js";
+import { rollbackCommand } from "./commands/rollback.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const cliPkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
 // Read version from the "creek" facade package (what users install),
@@ -30,7 +31,7 @@ catch {
 }
 const main = defineCommand({
     meta: {
-        name: "creek",
+        name: "⬡ creek",
         version,
         description: "Deploy full-stack apps to the edge",
     },
@@ -46,6 +47,7 @@ const main = defineCommand({
         claim: claimCommand,
         env: envCommand,
         domains: domainsCommand,
+        rollback: rollbackCommand,
     },
 });
 runMain(main);

package/dist/utils/output.d.ts

@@ -5,8 +5,13 @@
  * can produce structured output for agents, CI/CD, and pipes.
  */
 export declare const isTTY: boolean;
+/** A suggested next command for agents to follow. */
+export interface Breadcrumb {
+    command: string;
+    description: string;
+}
 /** Output structured JSON and exit. */
-export declare function jsonOutput(data: Record<string, unknown>, exitCode?: number): never;
+export declare function jsonOutput(data: Record<string, unknown>, exitCode?: number, breadcrumbs?: Breadcrumb[]): never;
 /** Resolve JSON mode: explicit --json flag OR non-TTY environment. */
 export declare function resolveJsonMode(args: {
     json?: boolean;
@@ -34,5 +39,8 @@ export declare function shouldAutoConfirm(args: {
     yes?: boolean;
 }): boolean;
 /** Output an error in the appropriate format and exit. */
-export declare function exitError(jsonMode: boolean, error: string, message: string, exitCode?: number): never;
+export declare function exitError(jsonMode: boolean, error: string, message: string, exitCode?: number, breadcrumbs?: Breadcrumb[]): never;
+/** Reusable breadcrumbs for common error states. */
+export declare const AUTH_BREADCRUMBS: Breadcrumb[];
+export declare const NO_PROJECT_BREADCRUMBS: Breadcrumb[];
 //# sourceMappingURL=output.d.ts.map

package/dist/utils/output.js

@@ -6,8 +6,9 @@
  */
 export const isTTY = process.stdout.isTTY ?? false;
 /** Output structured JSON and exit. */
-export function jsonOutput(data, exitCode = 0) {
-    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+export function jsonOutput(data, exitCode = 0, breadcrumbs) {
+    const output = breadcrumbs?.length ? { ...data, breadcrumbs } : data;
+    process.stdout.write(JSON.stringify(output, null, 2) + "\n");
     process.exit(exitCode);
 }
 /** Resolve JSON mode: explicit --json flag OR non-TTY environment. */
@@ -37,9 +38,18 @@ export function shouldAutoConfirm(args) {
     return args.yes === true || !isTTY;
 }
 /** Output an error in the appropriate format and exit. */
-export function exitError(jsonMode, error, message, exitCode = 1) {
+export function exitError(jsonMode, error, message, exitCode = 1, breadcrumbs) {
     if (jsonMode)
-        jsonOutput({ ok: false, error, message }, exitCode);
+        jsonOutput({ ok: false, error, message }, exitCode, breadcrumbs);
     return process.exit(exitCode);
 }
+/** Reusable breadcrumbs for common error states. */
+export const AUTH_BREADCRUMBS = [
+    { command: "creek login", description: "Authenticate interactively" },
+    { command: "creek login --token <KEY>", description: "Authenticate with API key (CI/CD)" },
+];
+export const NO_PROJECT_BREADCRUMBS = [
+    { command: "creek init", description: "Initialize creek.toml in current directory" },
+    { command: "creek deploy --demo", description: "Deploy a sample site to try Creek" },
+];
 //# sourceMappingURL=output.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solcreek/cli",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "CLI for the Creek deployment platform",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,7 +32,7 @@
     "directory": "packages/cli"
   },
   "dependencies": {
-    "@solcreek/sdk": "workspace:*",
+    "@solcreek/sdk": "^0.1.0-alpha.3",
     "citty": "^0.1.6",
     "consola": "^3.4.2",
     "esbuild": "^0.25.0",