@solidactions/cli 1.20.0 → 1.22.0

package/dist/commands/env-set.js

@@ -3,11 +3,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.GLOBAL_ENV_SCOPE_NOTE = void 0;
+exports.isNonTty = isNonTty;
 exports.envSet = envSet;
 const axios_1 = __importDefault(require("axios"));
 const chalk_1 = __importDefault(require("chalk"));
 const prompts_1 = __importDefault(require("prompts"));
 const api_1 = require("../utils/api");
+const env_1 = require("../utils/env");
+/** Returns true when stdin is not an interactive terminal (CI, pipes, scripts). */
+function isNonTty() {
+    return !process.stdin.isTTY;
+}
+/** Printed before a 2-arg (global-scope) write — Jordan's runs 3-7 footgun. */
+exports.GLOBAL_ENV_SCOPE_NOTE = [
+    'Note: no project specified — creating a GLOBAL variable.',
+    "  Global variables are NOT visible to a project's plain `env:` YAML declarations",
+    '  unless you map them (`solidactions env map …`).',
+    '  For a project variable, use: solidactions env set <project> KEY value',
+].join('\n');
 async function envSet(keyOrProject, valueOrKey, valueIfProject, options = {}) {
     const config = await (0, api_1.requireConfigWithWorkspace)();
     // Detect mode based on arguments
@@ -17,6 +31,10 @@ async function envSet(keyOrProject, valueOrKey, valueIfProject, options = {}) {
         const projectName = keyOrProject;
         const key = valueOrKey;
         const value = valueIfProject;
+        if ((0, env_1.isReservedEnvName)(key)) {
+            console.error(chalk_1.default.red((0, env_1.reservedEnvNameError)(key)));
+            process.exit(1);
+        }
         const environment = options.env || 'dev';
         // Build project slug
         const projectSlug = environment === 'production'
@@ -31,6 +49,11 @@ async function envSet(keyOrProject, valueOrKey, valueIfProject, options = {}) {
                 const mappings = mappingsResponse.data || [];
                 const existing = mappings.find((m) => m.env_name === key);
                 if (existing && existing.has_value) {
+                    if (isNonTty()) {
+                        console.error(chalk_1.default.red(`Variable "${key}" already has a value in "${projectName}" (${environment}). ` +
+                            `Pass -y / --yes to overwrite without confirmation.`));
+                        process.exit(1);
+                    }
                     console.log(chalk_1.default.yellow(`Variable "${key}" already has a value in "${projectName}" (${environment}).`));
                     const confirm = await (0, prompts_1.default)({
                         type: 'confirm',
@@ -83,6 +106,11 @@ async function envSet(keyOrProject, valueOrKey, valueIfProject, options = {}) {
         // Global mode: solidactions env set <key> <value>
         const key = keyOrProject;
         const value = valueOrKey;
+        if ((0, env_1.isReservedEnvName)(key)) {
+            console.error(chalk_1.default.red((0, env_1.reservedEnvNameError)(key)));
+            process.exit(1);
+        }
+        console.log(chalk_1.default.yellow(exports.GLOBAL_ENV_SCOPE_NOTE));
         const isSecret = options.secret || false;
         // Build the request body with per-environment values
         const body = {
@@ -119,6 +147,11 @@ async function envSet(keyOrProject, valueOrKey, valueIfProject, options = {}) {
             let action;
             if (existing) {
                 if (!options.yes) {
+                    if (isNonTty()) {
+                        console.error(chalk_1.default.red(`Global variable "${key}" already exists. ` +
+                            `Pass -y / --yes to overwrite without confirmation.`));
+                        process.exit(1);
+                    }
                     console.log(chalk_1.default.yellow(`Global variable "${key}" already exists.`));
                     const confirm = await (0, prompts_1.default)({
                         type: 'confirm',

package/dist/commands/init.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEMPLATE_FILES = void 0;
 exports.init = init;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -14,8 +15,9 @@ const EXAMPLES_OWNER = 'SolidActions';
 const EXAMPLES_REPO = 'solidactions-examples';
 const TEMPLATE_PREFIX = 'templates/minimal';
 // Tuples of [remote-path-suffix-under-template-prefix, local-path-relative-to-target].
-const TEMPLATE_FILES = [
+exports.TEMPLATE_FILES = [
     ['package.json', 'package.json'],
+    ['package-lock.json', 'package-lock.json'],
     ['tsconfig.json', 'tsconfig.json'],
     ['solidactions.yaml', 'solidactions.yaml'],
     ['.env.example', '.env.example'],
@@ -48,7 +50,7 @@ async function init(directory, options = {}) {
             process.exit(1);
         }
         console.log(chalk_1.default.blue(`Scaffolding "${projectName}" in ${targetDir}...`));
-        for (const [remoteSuffix, localSuffix] of TEMPLATE_FILES) {
+        for (const [remoteSuffix, localSuffix] of exports.TEMPLATE_FILES) {
             const remotePath = `${TEMPLATE_PREFIX}/${remoteSuffix}`;
             let content = await (0, github_1.fetchRawFile)(EXAMPLES_OWNER, EXAMPLES_REPO, remotePath);
             content = content.replace(/__PROJECT_NAME__/g, projectName);
@@ -69,9 +71,10 @@ async function init(directory, options = {}) {
         if (directory) {
             console.log(chalk_1.default.gray(`  cd ${directory}`));
         }
-        console.log(chalk_1.default.gray(`  # Fill in WEBHOOK_SECRET and any other env vars in solidactions.yaml:`));
-        console.log(chalk_1.default.gray(`  solidactions env set ${projectName} WEBHOOK_SECRET <your-secret> -e production`));
         console.log(chalk_1.default.gray(`  solidactions project deploy ${projectName} -e production`));
+        console.log(chalk_1.default.gray(`  # If your workflow uses a webhook, retrieve its auto-generated secret`));
+        console.log(chalk_1.default.gray(`  # and set that value in your sender (e.g. Telegram secret_token):`));
+        console.log(chalk_1.default.gray(`  solidactions webhook secret ${projectName} -e production`));
     }
     catch (err) {
         if (err.message?.includes('rate limit')) {

package/dist/commands/login.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConfig = getConfig;
 exports.saveConfig = saveConfig;
 exports.clearConfig = clearConfig;
+exports.resolveLoginHost = resolveLoginHost;
+exports.loginHostLines = loginHostLines;
 exports.login = login;
 exports.logout = logout;
 exports.whoami = whoami;
@@ -26,17 +28,27 @@ function saveConfig(config) {
 function clearConfig() {
     (0, config_1.removeConfigFile)((0, config_1.getGlobalConfigPath)());
 }
-async function login(apiKey, options) {
-    let host;
+function resolveLoginHost(options) {
     if (options.host) {
-        host = options.host;
+        return { host: options.host, isDefault: false };
     }
-    else if (options.dev) {
-        host = 'http://localhost:8000';
+    if (options.dev) {
+        return { host: 'http://localhost:8000', isDefault: false };
     }
-    else {
-        host = 'https://app.solidactions.com';
+    return { host: 'https://app.solidactions.com', isDefault: true };
+}
+function loginHostLines(resolved) {
+    if (resolved.isDefault) {
+        return [
+            `Logging into ${resolved.host} (SolidActions Cloud)`,
+            '  Self-hosted or local dev? Pass --host <url> (or --dev for http://localhost:8000)',
+        ];
     }
+    return [`Host: ${resolved.host}`];
+}
+async function login(apiKey, options) {
+    const resolved = resolveLoginHost(options);
+    const host = resolved.host;
     if (!apiKey || apiKey.trim().length === 0) {
         console.error(chalk_1.default.red('Error: API key is required.'));
         console.log(chalk_1.default.gray('Generate an API key at: ') + chalk_1.default.blue(`${host}/settings/api-keys`));
@@ -46,7 +58,9 @@ async function login(apiKey, options) {
     const target = await (0, config_write_target_1.decideWriteTarget)({ local: options.local, global: options.global });
     const targetPath = (0, config_write_target_1.pathForTarget)(target);
     console.log(chalk_1.default.blue(`Initializing SolidActions CLI...`));
-    console.log(chalk_1.default.gray(`Host: ${host}`));
+    for (const line of loginHostLines(resolved)) {
+        console.log(resolved.isDefault ? chalk_1.default.yellow(line) : chalk_1.default.gray(line));
+    }
     if ((0, config_1.readConfigFile)(targetPath)) {
         console.log(chalk_1.default.yellow(`Existing config at ${targetPath} will be overwritten.`));
     }

package/dist/commands/project-logs.js

@@ -3,16 +3,35 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBuildLogUrl = buildBuildLogUrl;
+exports.buildBuildLogRequest = buildBuildLogRequest;
 exports.logsBuild = logsBuild;
 const axios_1 = __importDefault(require("axios"));
 const chalk_1 = __importDefault(require("chalk"));
 const api_1 = require("../utils/api");
-async function logsBuild(projectName) {
+function buildBuildLogUrl(host, projectName, environment) {
+    if (environment) {
+        return `${host}/api/v1/projects/resolve/build-log`;
+    }
+    return `${host}/api/v1/projects/${projectName}/build-log`;
+}
+function buildBuildLogRequest(host, projectName, environment) {
+    if (environment) {
+        return {
+            url: `${host}/api/v1/projects/resolve/build-log`,
+            params: { name: projectName, environment },
+        };
+    }
+    return { url: `${host}/api/v1/projects/${projectName}/build-log` };
+}
+async function logsBuild(projectName, environment) {
     const config = await (0, api_1.requireConfigWithWorkspace)();
     console.log(chalk_1.default.blue(`Fetching build logs for project "${projectName}"...`));
+    const { url, params } = buildBuildLogRequest(config.host, projectName, environment);
     try {
-        const response = await axios_1.default.get(`${config.host}/api/v1/projects/${projectName}/build-log`, {
+        const response = await axios_1.default.get(url, {
             headers: (0, api_1.getApiHeaders)(config),
+            params,
         });
         const buildLog = response.data.build_log || response.data;
         if (!buildLog || buildLog.length === 0) {
@@ -29,7 +48,11 @@ async function logsBuild(projectName) {
                 console.error(chalk_1.default.red('Authentication failed. Run "solidactions login <api-key>" to re-configure.'));
             }
             else if (error.response.status === 404) {
-                console.error(chalk_1.default.red(`Project "${projectName}" not found.`));
+                console.error(chalk_1.default.red(error.response.data?.message ?? `Project "${projectName}" not found.`));
+                const envs = error.response.data?.available_environments;
+                if (envs && envs.length > 0) {
+                    console.error(chalk_1.default.yellow(`Available environments: ${envs.join(', ')}. Pass -e <env> to select one.`));
+                }
             }
             else {
                 console.error(chalk_1.default.red(`Failed: ${error.response.status}`), error.response.data);

package/dist/commands/run-list.js

@@ -3,38 +3,54 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRunListParams = buildRunListParams;
 exports.runs = runs;
 exports.summaryStatusLabel = summaryStatusLabel;
 exports.detailedOutcomeTag = detailedOutcomeTag;
 const axios_1 = __importDefault(require("axios"));
 const chalk_1 = __importDefault(require("chalk"));
 const api_1 = require("../utils/api");
-async function runs(projectName, options = {}) {
-    const config = await (0, api_1.requireConfigWithWorkspace)();
-    // Default limit is lower for --detailed (more data per run)
+/**
+ * Build the params object for GET /api/v1/runs.
+ * Extracted as a pure function so it can be unit-tested without mocking axios.
+ */
+function buildRunListParams(projectName, options = {}) {
     const defaultLimit = options.detailed ? 5 : 20;
     const limit = options.limit || defaultLimit;
+    const params = { limit };
+    if (projectName)
+        params.project = projectName;
+    if (options.environment)
+        params.environment = options.environment;
+    if (options.offset)
+        params.offset = options.offset;
+    if (options.status)
+        params.status = options.status;
+    if (options.since)
+        params.since = parseSince(options.since);
+    if (options.workflow)
+        params.workflow = options.workflow;
+    if (options.detailed)
+        params.detailed = '1';
+    if (options.hasErrors)
+        params.has_errors = '1';
+    return params;
+}
+async function runs(projectName, options = {}) {
+    const config = await (0, api_1.requireConfigWithWorkspace)();
     try {
-        const params = { limit };
-        if (projectName)
-            params.project = projectName;
-        if (options.offset)
-            params.offset = options.offset;
-        if (options.status)
-            params.status = options.status;
-        if (options.since)
-            params.since = parseSince(options.since);
-        if (options.workflow)
-            params.workflow = options.workflow;
-        if (options.detailed)
-            params.detailed = '1';
-        if (options.hasErrors)
-            params.has_errors = '1';
+        const params = buildRunListParams(projectName, options);
         const response = await axios_1.default.get(`${config.host}/api/v1/runs`, {
             headers: (0, api_1.getApiHeaders)(config),
             params,
         });
         const runsList = response.data.data || response.data;
+        // Check server-side error fields FIRST (project_not_found comes back as 200 with data:[])
+        const serverError = response.data.error;
+        if (serverError === 'project_not_found') {
+            console.error(chalk_1.default.red(response.data.message || `Project '${projectName}' not found.`));
+            process.exit(1);
+        }
         if (!runsList || runsList.length === 0) {
             if (options.json) {
                 console.log('[]');
@@ -58,7 +74,13 @@ async function runs(projectName, options = {}) {
     }
     catch (error) {
         if (error.response) {
-            if (error.response.status === 401) {
+            // ambiguous_project is 422 — axios throws, so handle here
+            if (error.response.status === 422 && error.response.data?.error === 'ambiguous_project') {
+                const envs = (error.response.data.environments ?? []).join(', ');
+                console.error(chalk_1.default.yellow(`Ambiguous project '${projectName}': found in environments: ${envs}.`));
+                console.error(chalk_1.default.yellow(`Pass -e <env> to disambiguate, e.g.: solidactions run list ${projectName} -e dev`));
+            }
+            else if (error.response.status === 401) {
                 console.error(chalk_1.default.red('Authentication failed. Run "solidactions login <api-key>" to re-configure.'));
             }
             else {

package/dist/commands/run-view.js

@@ -4,6 +4,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runView = runView;
+exports.displayStepsTable = displayStepsTable;
+exports.flattenSteps = flattenSteps;
+exports.stepDisplayStatus = stepDisplayStatus;
+exports.errorMessage = errorMessage;
 const axios_1 = __importDefault(require("axios"));
 const chalk_1 = __importDefault(require("chalk"));
 const api_1 = require("../utils/api");
@@ -149,7 +153,7 @@ function displayFullView(runData, timeline, steps, logsData) {
     if (runData.error) {
         console.log('');
         console.log(chalk_1.default.bold.red('  Error:'));
-        console.log(chalk_1.default.red(`    ${runData.error}`));
+        console.log(chalk_1.default.red(`    ${errorMessage(runData.error)}`));
     }
     // Logs snippet
     const logs = logsData.logs || '';
@@ -203,11 +207,22 @@ function displayStepsTable(steps, indent = '  ') {
     console.log(chalk_1.default.gray(`${indent}${'─'.repeat(72)}`));
     for (const step of steps) {
         const name = (step.name || '?').padEnd(24);
-        const status = step.completedAt ? 'completed' : step.startedAt ? 'running' : 'pending';
+        const status = stepDisplayStatus(step);
         const statusColor = getStatusColor(status);
         const duration = formatDuration(step.durationMs);
-        const output = step.output ? truncate(JSON.stringify(unwrapOutput(step.output)), 40) : '-';
-        console.log(`${indent}${name}${statusColor(status.padEnd(12))}${chalk_1.default.gray(duration.padEnd(12))}${chalk_1.default.gray(output)}`);
+        // A failed step's error is more useful than its (null) output — show it, red.
+        const output = step.error
+            ? chalk_1.default.red(truncate(errorMessage(step.error).replace(/\s+/g, ' ').trim(), 40))
+            : chalk_1.default.gray(step.output ? truncate(JSON.stringify(unwrapOutput(step.output)), 40) : '-');
+        console.log(`${indent}${name}${statusColor(status.padEnd(12))}${chalk_1.default.gray(duration.padEnd(12))}${output}`);
+    }
+    // Untruncated first failure below the table: `run view` alone must be
+    // enough to diagnose (Wall #5 — failed steps used to render "completed").
+    const firstFailed = steps.find((s) => stepDisplayStatus(s).toLowerCase() === 'failed' && s.error);
+    if (firstFailed) {
+        console.log('');
+        console.log(chalk_1.default.bold.red(`${indent}Step "${firstFailed.name}" failed:`));
+        console.log(chalk_1.default.red(`${indent}  ${errorMessage(firstFailed.error)}`));
     }
 }
 // ─── Utility ───────────────────────────────────────────────────────────────
@@ -221,17 +236,52 @@ function flattenSteps(workers) {
                 completedAt: step.completed_at || null,
                 durationMs: step.duration_ms ?? null,
                 output: step.output ?? null,
+                status: step.status ?? null,
+                error: step.error ?? null,
             });
         }
     }
     return steps;
 }
+/** Server-derived status wins; timestamp heuristic only for pre-status API responses. */
+function stepDisplayStatus(step) {
+    return step.status ?? (step.completedAt ? 'completed' : step.startedAt ? 'running' : 'pending');
+}
 function unwrapOutput(output) {
     if (output && output.__solidactions_serializer === 'superjson' && output.json) {
         return output.json;
     }
     return output;
 }
+/**
+ * Normalize a step/run `error` field to a readable string. Errors arrive in
+ * one of three shapes: a plain string (legacy servers), a superjson-wrapped
+ * `{ json: { name, message, stack }, __solidactions_serializer: 'superjson' }`
+ * object (steps endpoint), or that same shape JSON.stringified into a string
+ * (run-level `error` field) — confirmed live via GET /api/v1/runs/{id} and
+ * .../steps. Without this, a thrown Error renders as "[object Object]".
+ */
+function errorMessage(error) {
+    if (error === null || error === undefined)
+        return '';
+    let value = error;
+    if (typeof value === 'string') {
+        try {
+            value = JSON.parse(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    if (value && typeof value === 'object' && value.__solidactions_serializer === 'superjson' && value.json) {
+        const inner = value.json;
+        if (inner && typeof inner === 'object' && (inner.name || inner.message)) {
+            return inner.name && inner.message ? `${inner.name}: ${inner.message}` : String(inner.name || inner.message);
+        }
+        return JSON.stringify(inner);
+    }
+    return typeof value === 'object' ? JSON.stringify(value) : String(value);
+}
 function formatDuration(ms) {
     if (ms === null || ms === undefined)
         return '-';

package/dist/commands/schedule-list.js

@@ -20,18 +20,20 @@ async function scheduleList(projectName) {
             return;
         }
         console.log('');
-        console.log(chalk_1.default.gray('ID'.padEnd(8) + 'WORKFLOW'.padEnd(25) + 'CRON'.padEnd(18) + 'ENABLED'.padEnd(10) + 'NEXT RUN'));
-        console.log(chalk_1.default.gray('-'.repeat(95)));
+        console.log(chalk_1.default.gray('ID'.padEnd(8) + 'WORKFLOW'.padEnd(25) + 'CRON'.padEnd(18) + 'TIMEZONE'.padEnd(20) + 'ENABLED'.padEnd(10) + 'NEXT RUN'));
+        console.log(chalk_1.default.gray('-'.repeat(105)));
         for (const schedule of schedules) {
             const id = schedule.id?.toString() || '?';
             const workflow = schedule.workflow_name || schedule.workflow_slug || '?';
             const cron = schedule.cron_expression || '?';
+            const timezone = schedule.timezone || 'UTC';
             const enabled = schedule.enabled;
             const nextRun = schedule.next_run_at ? formatRelativeTime(schedule.next_run_at) : '-';
             const enabledColor = enabled ? chalk_1.default.green : chalk_1.default.red;
             console.log(chalk_1.default.gray(id.padEnd(8)) +
                 workflow.padEnd(25) +
                 chalk_1.default.cyan(cron.padEnd(18)) +
+                chalk_1.default.gray(timezone.padEnd(20)) +
                 enabledColor((enabled ? 'yes' : 'no').padEnd(10)) +
                 chalk_1.default.gray(nextRun));
         }

package/dist/commands/schedule-set.js

@@ -3,11 +3,38 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSchedulePayload = buildSchedulePayload;
+exports.timezoneMismatch = timezoneMismatch;
+exports.timezoneMismatchRemedy = timezoneMismatchRemedy;
 exports.scheduleSet = scheduleSet;
 const axios_1 = __importDefault(require("axios"));
 const chalk_1 = __importDefault(require("chalk"));
 const prompts_1 = __importDefault(require("prompts"));
 const api_1 = require("../utils/api");
+function buildSchedulePayload(cron, options, inputData) {
+    const payload = { cron };
+    if (options.workflow) {
+        payload.workflow = options.workflow;
+    }
+    if (inputData) {
+        payload.input = inputData;
+    }
+    if (options.timezone) {
+        payload.timezone = options.timezone;
+    }
+    return payload;
+}
+/** True when the user asked for a timezone the server did not apply (pre-item-5-App server). */
+function timezoneMismatch(requested, returned) {
+    return requested !== undefined && returned !== requested;
+}
+/**
+ * Remediation text for a timezoneMismatch. `schedule delete` takes a numeric
+ * <schedule-id>, not a workflow name — point at `schedule list` first to find it.
+ */
+function timezoneMismatchRemedy(projectName) {
+    return `Your server may not support schedule timezones yet; update the server, or run 'solidactions schedule list ${projectName}' to find the schedule ID and remove it with: solidactions schedule delete ${projectName} <schedule-id>`;
+}
 async function scheduleSet(projectName, cron, options) {
     const config = await (0, api_1.requireConfigWithWorkspace)();
     // Parse input JSON if provided
@@ -66,20 +93,25 @@ async function scheduleSet(projectName, cron, options) {
     }
     console.log(chalk_1.default.blue(`Setting schedule for project "${projectName}"...`));
     try {
-        const payload = {
-            cron,
-        };
-        if (options.workflow) {
-            payload.workflow = options.workflow;
-        }
-        if (inputData) {
-            payload.input = inputData;
-        }
-        await axios_1.default.post(`${config.host}/api/v1/projects/${projectName}/schedules`, payload, {
+        const payload = buildSchedulePayload(cron, options, inputData);
+        const response = await axios_1.default.post(`${config.host}/api/v1/projects/${projectName}/schedules`, payload, {
             headers: (0, api_1.getApiHeaders)(config, 'application/json'),
         });
+        // Verify, don't trust: a server predating timezone support silently
+        // strips the field, but the schedule is already persisted by this point —
+        // it's live and running in the wrong timezone. Report the persisted fact
+        // and the remedy, not a hypothetical.
+        const returnedTz = response.data?.schedule?.timezone;
+        if (timezoneMismatch(options.timezone, returnedTz)) {
+            console.error(chalk_1.default.red(`A schedule was created but is running in ${returnedTz ?? 'UTC'} — not ${options.timezone} as requested.`));
+            console.error(chalk_1.default.red(timezoneMismatchRemedy(projectName)));
+            process.exit(1);
+        }
         console.log(chalk_1.default.green(`Schedule set successfully!`));
         console.log(chalk_1.default.gray(`  Cron: ${cron}`));
+        if (options.timezone) {
+            console.log(chalk_1.default.gray(`  Timezone: ${options.timezone}`));
+        }
         if (options.workflow) {
             console.log(chalk_1.default.gray(`  Workflow: ${options.workflow}`));
         }

package/dist/commands/webhook-secret.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSecretOutput = formatSecretOutput;
+exports.webhookSecret = webhookSecret;
+const axios_1 = __importDefault(require("axios"));
+const chalk_1 = __importDefault(require("chalk"));
+const api_1 = require("../utils/api");
+function formatSecretOutput(rows, workflowFilter) {
+    if (workflowFilter) {
+        const match = rows.find((r) => r.workflow_name === workflowFilter);
+        if (!match)
+            return `No webhook named "${workflowFilter}" found.`;
+        return match.webhook_secret ?? '(secret not returned — check your access level)';
+    }
+    if (rows.length === 1) {
+        return rows[0].webhook_secret ?? '(secret not returned — check your access level)';
+    }
+    const lines = rows.map((r) => `${(r.workflow_name ?? '?').padEnd(32)}${r.webhook_secret ?? '(none)'}`);
+    return ['WORKFLOW'.padEnd(32) + 'SECRET', '-'.repeat(80), ...lines].join('\n');
+}
+async function webhookSecret(projectName, options = {}) {
+    const format = options.format ?? 'text';
+    if (format !== 'text' && format !== 'json') {
+        console.error(chalk_1.default.red(`Invalid --format: ${format}. Expected 'text' or 'json'.`));
+        process.exit(1);
+    }
+    const config = await (0, api_1.requireConfigWithWorkspace)();
+    const environment = options.env || 'dev';
+    const projectSlug = environment === 'production' ? projectName : `${projectName}-${environment}`;
+    if (format === 'text') {
+        process.stderr.write(chalk_1.default.dim(`(environment: ${environment} — pass -e <env> to change)\n`));
+    }
+    try {
+        const response = await axios_1.default.get(`${config.host}/api/v1/projects/${projectSlug}/webhooks`, {
+            headers: (0, api_1.getApiHeaders)(config),
+            params: { show_secrets: 'true' },
+        });
+        const rows = response.data.data ?? [];
+        if (rows.length === 0) {
+            console.error(chalk_1.default.yellow(`No webhook workflows found for project "${projectName}"${environment !== 'production' ? ` (${environment})` : ''}.`));
+            process.exit(1);
+        }
+        if (format === 'json') {
+            const out = options.workflow
+                ? rows
+                    .filter((r) => r.workflow_name === options.workflow)
+                    .map((r) => ({ workflow: r.workflow_name, secret: r.webhook_secret }))
+                : rows.map((r) => ({ workflow: r.workflow_name, secret: r.webhook_secret }));
+            console.log(JSON.stringify(out, null, 2));
+            return;
+        }
+        console.log(formatSecretOutput(rows, options.workflow));
+    }
+    catch (error) {
+        if (error.response) {
+            if (error.response.status === 401) {
+                console.error(chalk_1.default.red('Authentication failed. Run "solidactions login <api-key>" to re-configure.'));
+            }
+            else if (error.response.status === 404) {
+                console.error(chalk_1.default.red(`Project "${projectName}" not found.`));
+            }
+            else {
+                console.error(chalk_1.default.red(`Failed: ${error.response.status}`), error.response.data);
+            }
+        }
+        else {
+            console.error(chalk_1.default.red('Connection failed:'), error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/index.js

@@ -26,6 +26,7 @@ const schedule_set_1 = require("./commands/schedule-set");
 const schedule_list_1 = require("./commands/schedule-list");
 const schedule_delete_1 = require("./commands/schedule-delete");
 const webhook_list_1 = require("./commands/webhook-list");
+const webhook_secret_1 = require("./commands/webhook-secret");
 const dev_1 = require("./commands/dev");
 const ai_init_1 = require("./commands/ai-init");
 const ai_examples_1 = require("./commands/ai-examples");
@@ -158,8 +159,13 @@ project
     .option('-e, --env <environment>', 'Target environment (production/staging/dev). Required on first deploy of a new project.')
     .option('--create', 'Create environment project if it doesn\'t exist')
     .option('--config-only', 'Sync YAML env declarations without building/deploying')
+    .option('--no-cache', 'Force a fresh build, bypassing all build caches')
+    .option('--force-rebuild', 'Force a fresh build, bypassing all build caches (alias for --no-cache)')
     .action((projectName, path, options) => {
-    (0, deploy_1.deploy)(projectName, path, options);
+    // Commander's negation convention maps --no-cache to options.cache === false
+    // (NOT options.noCache). Normalize both flags to a single boolean.
+    const noCache = options.cache === false || options.forceRebuild === true;
+    (0, deploy_1.deploy)(projectName, path, { ...options, noCache });
 });
 project
     .command('pull')
@@ -173,9 +179,10 @@ project
 project
     .command('logs')
     .description('View build/deployment logs for a project')
-    .argument('<project>', 'Project name')
-    .action((projectName) => {
-    (0, project_logs_1.logsBuild)(projectName);
+    .argument('<project>', 'Project name (or family name with -e)')
+    .option('-e, --environment <environment>', 'Environment to resolve (production/staging/dev)')
+    .action((projectName, options) => {
+    (0, project_logs_1.logsBuild)(projectName, options.environment);
 });
 project
     .command('list')
@@ -210,6 +217,7 @@ runCmd
     .option('--detailed', 'Include timeline, steps, and logs per run (default limit: 5)')
     .option('--has-errors', 'Show only runs with errors (step errors, retries, or degraded results)')
     .option('--json', 'Output as JSON')
+    .option('-e, --environment <environment>', 'Environment to filter by (production/staging/dev)')
     .action((projectName, options) => {
     (0, run_list_1.runs)(projectName, options);
 });
@@ -306,6 +314,7 @@ schedule
     .argument('<cron>', 'Cron expression (e.g., "0 9 * * *" for daily at 9am)')
     .option('-w, --workflow <name>', 'Workflow name (if project has multiple)')
     .option('-i, --input <json>', 'JSON input to pass to scheduled runs')
+    .option('-z, --timezone <iana>', 'IANA timezone the cron is evaluated in (e.g. America/Chicago); defaults to UTC')
     .option('-y, --yes', 'Skip confirmation if schedule already exists')
     .action((projectName, cron, options) => {
     (0, schedule_set_1.scheduleSet)(projectName, cron, options);
@@ -340,6 +349,16 @@ webhook
     .action((projectName, options) => {
     (0, webhook_list_1.webhookList)(projectName, options);
 });
+webhook
+    .command('secret')
+    .description('Print the webhook secret for a project (set this value in your sender)')
+    .argument('<project>', 'Project name')
+    .option('-e, --env <environment>', 'Environment (production/staging/dev)')
+    .option('--workflow <name>', 'Filter to a specific workflow by name')
+    .option('--format <format>', 'Output format: text or json', 'text')
+    .action((projectName, options) => {
+    (0, webhook_secret_1.webhookSecret)(projectName, options);
+});
 // =============================================================================
 // workspace <subcommand>
 // =============================================================================