@solidactions/cli 0.7.3 → 1.1.0

package/README.md

@@ -11,39 +11,82 @@ npm install -g @solidactions/cli
 ## Quick Start
 
 ```bash
-# Initialize with your API key
-solidactions init <api-key>
-
-# Deploy a project
-solidactions deploy <project-name> <path>
+solidactions init <api-key>                          # Initialize (prompts for workspace)
+solidactions init <api-key> --workspace <name>       # Initialize with workspace
+solidactions project deploy <project> <path>         # Deploy a project
+solidactions run start <project> <workflow>           # Trigger a workflow
+solidactions run view <run-id>                        # Inspect a run
 ```
 
 ## Commands
 
+Use `solidactions <command> --help` for full flag details on any command.
+
+### Top-level
+
 | Command | Description |
 |---------|-------------|
-| `init <api-key>` | Initialize CLI with your API key |
+| `init <api-key>` | Initialize CLI with API key |
 | `logout` | Remove saved credentials |
 | `whoami` | Show current configuration |
-| `deploy <project> [path]` | Deploy a project to SolidActions |
-| `pull <project> [path]` | Pull project source from SolidActions |
-| `run <project> <workflow>` | Trigger a workflow run |
-| `runs [project]` | List recent workflow runs |
-| `logs <run-id>` | View logs for a workflow run |
-| `logs:build <project>` | View build/deployment logs |
-| `env:set <key> <value>` | Set a global variable (create or update) |
-| `env:set <project> <key> <value>` | Set a project variable (create or update) |
-| `env:list [project]` | List environment variables |
-| `env:delete <key>` | Delete an environment variable |
-| `env:map <project> <key> <global-key>` | Map a global variable to a project |
-| `env:pull <project>` | Pull resolved env vars (including OAuth tokens) to a local file |
-| `env:push <project> [path]` | Push .env values to a project |
-| `schedule:set <project> <cron>` | Set a cron schedule for a workflow |
-| `schedule:list <project>` | List schedules for a project |
-| `schedule:delete <project> <id>` | Delete a schedule |
-| `webhooks <project>` | List webhook URLs for a project |
-
-See [docs/cli.md](docs/cli.md) for full documentation.
+| `dev <file>` | Run a workflow locally (no deploy needed) |
+
+### project
+
+| Command | Key Flags | Description |
+|---------|-----------|-------------|
+| `project deploy <name> [path]` | `-e`, `--create`, `--config-only` | Deploy or sync config only |
+| `project pull <name> [path]` | `-y` | Pull source (warns before overwriting) |
+| `project logs <name>` | | View build logs |
+| `project list` | | List all projects |
+
+### run
+
+| Command | Key Flags | Description |
+|---------|-----------|-------------|
+| `run start <project> <workflow>` | `-e`, `-i`, `-w` | Trigger a workflow run |
+| `run list [project]` | `--json`, `--detailed`, `--status`, `--since`, `--workflow`, `--limit`, `--offset` | List and filter runs |
+| `run view <run-id>` | `--json`, `--timeline`, `--steps`, `--logs` | Inspect a run |
+
+### env
+
+| Command | Key Flags | Description |
+|---------|-----------|-------------|
+| `env set <key> <value>` | `-s`, `-y`, `--staging-value`, `--dev-value` | Set global variable (warns before overwriting) |
+| `env set <project> <key> <value>` | `-e`, `-s`, `-y` | Set project variable (warns before overwriting) |
+| `env list [project]` | `-e` | List variables |
+| `env delete <key-or-project> [key]` | `-y` | Delete a variable |
+| `env map <project> <key> <global-key>` | `-y` | Map global to project key (warns before overwriting) |
+| `env pull <project>` | `-e`, `-o`, `-y`, `--update-oauth` | Pull resolved env vars to .env file |
+| `env push <project> [path]` | `-e`, `-y`, `--new-only`, `--include-undeclared` | Push .env values to project |
+
+### schedule
+
+| Command | Key Flags | Description |
+|---------|-----------|-------------|
+| `schedule set <project> <cron>` | `-w`, `-i`, `-y` | Set cron schedule (warns if exists) |
+| `schedule list <project>` | | List schedules |
+| `schedule delete <project> <id>` | `-y` | Delete a schedule |
+
+### webhook
+
+| Command | Key Flags | Description |
+|---------|-----------|-------------|
+| `webhook list <project>` | `-e`, `--show-secrets` | List webhook URLs |
+
+### workspace
+
+| Command | Description |
+|---------|-------------|
+| `workspace list` | List all workspaces |
+| `workspace set <id>` | Set active workspace (by ID, slug, or name) |
+
+### ai
+
+| Command | Key Flags | Description |
+|---------|-----------|-------------|
+| `ai init` | `--claude`, `--agents` | Install AI helper docs |
+| `ai examples [names...]` | `--all`, `--overwrite` | Install example workflows |
 
 ## Development
 

package/dist/commands/ai-examples.js

@@ -83,7 +83,7 @@ async function aiExamples(names, options = {}) {
         // Detect AI helper file and upsert examples reference
         const aiHelperFile = (0, markers_1.findAiHelperFile)();
         if (!aiHelperFile) {
-            console.log(chalk_1.default.yellow('No AI helper file found. Run "solidactions ai:init" first to create one.'));
+            console.log(chalk_1.default.yellow('No AI helper file found. Run "solidactions ai init" first to create one.'));
         }
         else {
             // List ALL installed examples (existing + newly installed)

package/dist/commands/deploy.js

@@ -191,6 +191,16 @@ async function deploy(projectName, sourcePath, options = {}) {
             process.exit(1);
         }
     }
+    // --config-only: sync YAML env declarations without building
+    if (options.configOnly) {
+        if (!yamlConfig) {
+            console.error(chalk_1.default.red('Cannot sync config: solidactions.yaml not found or invalid.'));
+            process.exit(1);
+        }
+        await pushYamlDeclarations(config, projectSlug, yamlConfig);
+        console.log(chalk_1.default.green(`✓ Config synced for ${projectSlug}${envLabel}`));
+        return;
+    }
     const archivePath = path_1.default.join(sourceDir, '.steps-deploy.tar.gz');
     const output = fs_1.default.createWriteStream(archivePath);
     const archive = (0, archiver_1.default)('tar', { gzip: true, gzipOptions: { level: 9 } });
@@ -302,7 +312,7 @@ async function deploy(projectName, sourcePath, options = {}) {
     });
     // Dockerfile always at archive root, referencing tenantcode/
     const universalDockerfile = [
-        'FROM node:20-alpine',
+        'FROM node:24-alpine',
         'WORKDIR /app',
         'COPY tenantcode/package.json tenantcode/package-lock.json* ./',
         'RUN npm install',

package/dist/commands/env-map.js

@@ -6,8 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.envMap = envMap;
 const axios_1 = __importDefault(require("axios"));
 const chalk_1 = __importDefault(require("chalk"));
+const prompts_1 = __importDefault(require("prompts"));
 const api_1 = require("../utils/api");
-async function envMap(projectName, projectKey, globalKey) {
+async function envMap(projectName, projectKey, globalKey, options = {}) {
     const config = await (0, api_1.requireConfigWithWorkspace)();
     console.log(chalk_1.default.blue(`Mapping global variable "${globalKey}" to project key "${projectKey}" in "${projectName}"...`));
     try {
@@ -19,9 +20,31 @@ async function envMap(projectName, projectKey, globalKey) {
         const globalVar = variables.find((v) => v.key === globalKey);
         if (!globalVar) {
             console.error(chalk_1.default.red(`Global variable "${globalKey}" not found.`));
-            console.log(chalk_1.default.gray('Create it with: solidactions env:set ' + globalKey + ' <value>'));
+            console.log(chalk_1.default.gray('Create it with: solidactions env set ' + globalKey + ' <value>'));
             process.exit(1);
         }
+        // Check if project key already has a mapping
+        if (!options.yes) {
+            const mappingsResponse = await axios_1.default.get(`${config.host}/api/v1/projects/${projectName}/variable-mappings`, { headers: (0, api_1.getApiHeaders)(config) });
+            const mappings = mappingsResponse.data || [];
+            const existing = mappings.find((m) => m.env_name === projectKey);
+            if (existing && (existing.has_value || existing.global_variable_id)) {
+                const currentSource = existing.global_variable_id
+                    ? `mapped to global "${existing.global_variable_key || 'unknown'}"`
+                    : 'has a local value';
+                console.log(chalk_1.default.yellow(`"${projectKey}" already ${currentSource} in "${projectName}".`));
+                const confirm = await (0, prompts_1.default)({
+                    type: 'confirm',
+                    name: 'proceed',
+                    message: 'Overwrite mapping?',
+                    initial: false,
+                });
+                if (!confirm.proceed) {
+                    console.log(chalk_1.default.gray('Cancelled.'));
+                    return;
+                }
+            }
+        }
         // Create the mapping
         await axios_1.default.post(`${config.host}/api/v1/projects/${projectName}/variable-mappings`, {
             project_key: projectKey,

package/dist/commands/env-pull.js

@@ -147,7 +147,7 @@ async function envPull(projectName, options = {}) {
         // Full pull: Build .env file content
         const lines = [];
         lines.push(`# Environment variables for ${projectName} (${environment})`);
-        lines.push(`# Generated by solidactions env:pull on ${new Date().toISOString()}`);
+        lines.push(`# Generated by solidactions env pull on ${new Date().toISOString()}`);
         lines.push('');
         let count = 0;
         let secretCount = 0;
@@ -208,7 +208,7 @@ async function envPull(projectName, options = {}) {
             else if (error.response.status === 404) {
                 console.error(chalk_1.default.red(`Project "${projectSlug}" not found.`));
                 if (environment !== 'production') {
-                    console.log(chalk_1.default.gray(`Try deploying with: solidactions deploy ${projectName} --env ${environment} --create`));
+                    console.log(chalk_1.default.gray(`Try deploying with: solidactions project deploy ${projectName} --env ${environment} --create`));
                 }
             }
             else {

package/dist/commands/env-push.js

@@ -92,7 +92,7 @@ async function envPush(projectName, sourcePath, options = {}) {
         }
         else if (error.response?.status === 404) {
             console.error(chalk_1.default.red(`Project "${projectSlug}" not found.`));
-            console.log(chalk_1.default.gray(`Deploy first with: solidactions deploy ${projectName} --env ${environment}` + (environment !== 'production' ? ' --create' : '')));
+            console.log(chalk_1.default.gray(`Deploy first with: solidactions project deploy ${projectName} --env ${environment}` + (environment !== 'production' ? ' --create' : '')));
             process.exit(1);
         }
         throw error;

package/dist/commands/env-set.js

@@ -6,13 +6,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 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");
 async function envSet(keyOrProject, valueOrKey, valueIfProject, options = {}) {
     const config = await (0, api_1.requireConfigWithWorkspace)();
     // Detect mode based on arguments
     const isProjectMode = valueIfProject !== undefined;
     if (isProjectMode) {
-        // Project mode: solidactions env:set <project> <key> <value>
+        // Project mode: solidactions env set <project> <key> <value>
         const projectName = keyOrProject;
         const key = valueOrKey;
         const value = valueIfProject;
@@ -24,6 +25,25 @@ async function envSet(keyOrProject, valueOrKey, valueIfProject, options = {}) {
         // Auto-detect secrets
         const isSecret = options.secret || /secret|key|token|password|credential/i.test(key);
         try {
+            // Check if variable already has a value
+            if (!options.yes) {
+                const mappingsResponse = await axios_1.default.get(`${config.host}/api/v1/projects/${projectSlug}/variable-mappings?reveal=true`, { headers: (0, api_1.getApiHeaders)(config) });
+                const mappings = mappingsResponse.data || [];
+                const existing = mappings.find((m) => m.env_name === key);
+                if (existing && existing.has_value) {
+                    console.log(chalk_1.default.yellow(`Variable "${key}" already has a value in "${projectName}" (${environment}).`));
+                    const confirm = await (0, prompts_1.default)({
+                        type: 'confirm',
+                        name: 'proceed',
+                        message: 'Overwrite?',
+                        initial: false,
+                    });
+                    if (!confirm.proceed) {
+                        console.log(chalk_1.default.gray('Cancelled.'));
+                        return;
+                    }
+                }
+            }
             // Use bulk endpoint for upsert
             const response = await axios_1.default.post(`${config.host}/api/v1/projects/${projectSlug}/variable-mappings/bulk`, {
                 variables: [{
@@ -60,7 +80,7 @@ async function envSet(keyOrProject, valueOrKey, valueIfProject, options = {}) {
         }
     }
     else {
-        // Global mode: solidactions env:set <key> <value>
+        // Global mode: solidactions env set <key> <value>
         const key = keyOrProject;
         const value = valueOrKey;
         const isSecret = options.secret || false;
@@ -98,6 +118,19 @@ async function envSet(keyOrProject, valueOrKey, valueIfProject, options = {}) {
             const existing = variables.find((v) => v.key === key);
             let action;
             if (existing) {
+                if (!options.yes) {
+                    console.log(chalk_1.default.yellow(`Global variable "${key}" already exists.`));
+                    const confirm = await (0, prompts_1.default)({
+                        type: 'confirm',
+                        name: 'proceed',
+                        message: 'Overwrite?',
+                        initial: false,
+                    });
+                    if (!confirm.proceed) {
+                        console.log(chalk_1.default.gray('Cancelled.'));
+                        return;
+                    }
+                }
                 await axios_1.default.put(`${config.host}/api/v1/variables/${existing.id}`, body, {
                     headers: (0, api_1.getApiHeaders)(config, 'application/json'),
                 });

package/dist/commands/init.js

@@ -83,13 +83,13 @@ async function init(apiKey, options) {
         }
     }
     catch {
-        console.log(chalk_1.default.yellow('Could not set workspace. Run `solidactions workspace:set` later.'));
+        console.log(chalk_1.default.yellow('Could not set workspace. Run `solidactions workspace set` later.'));
     }
     console.log('');
     console.log(chalk_1.default.blue('Quick start:'));
-    console.log(chalk_1.default.gray('  solidactions deploy <project-name>    Deploy current directory'));
-    console.log(chalk_1.default.gray('  solidactions run <project> <workflow> Run a workflow'));
-    console.log(chalk_1.default.gray('  solidactions runs                     List recent runs'));
+    console.log(chalk_1.default.gray('  solidactions project deploy <name>    Deploy current directory'));
+    console.log(chalk_1.default.gray('  solidactions run start <proj> <wf>    Run a workflow'));
+    console.log(chalk_1.default.gray('  solidactions run list                 List recent runs'));
 }
 async function logout() {
     if (fs_1.default.existsSync(CONFIG_FILE)) {

package/dist/commands/project-list.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectList = projectList;
+const axios_1 = __importDefault(require("axios"));
+const chalk_1 = __importDefault(require("chalk"));
+const api_1 = require("../utils/api");
+async function projectList() {
+    const config = await (0, api_1.requireConfigWithWorkspace)();
+    console.log(chalk_1.default.blue('Projects:\n'));
+    try {
+        const response = await axios_1.default.get(`${config.host}/api/v1/projects`, {
+            headers: (0, api_1.getApiHeaders)(config),
+        });
+        const projects = response.data.data || [];
+        if (projects.length === 0) {
+            console.log(chalk_1.default.gray('No projects found.'));
+            return;
+        }
+        console.log(chalk_1.default.gray('NAME'.padEnd(25) + 'STATUS'.padEnd(15) + 'SNAPSHOT'.padEnd(30) + 'ENVIRONMENTS'));
+        console.log(chalk_1.default.gray('-'.repeat(100)));
+        for (const project of projects) {
+            const name = (project.name || '?').padEnd(25);
+            const status = project.status || '?';
+            const statusColor = status === 'ready' ? chalk_1.default.green : status === 'building' ? chalk_1.default.yellow : chalk_1.default.gray;
+            const snapshot = (project.snapshot_name || '-').padEnd(30);
+            const envs = (project.environments || [project.environment || 'production']).join(', ');
+            console.log(name +
+                statusColor(status.padEnd(15)) +
+                chalk_1.default.gray(snapshot) +
+                chalk_1.default.gray(envs));
+        }
+        console.log('');
+        console.log(chalk_1.default.gray(`${projects.length} project(s)`));
+    }
+    catch (error) {
+        if (error.response) {
+            if (error.response.status === 401) {
+                console.error(chalk_1.default.red('Authentication failed. Run "solidactions init <api-key>" to re-configure.'));
+            }
+            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/commands/pull.js

@@ -6,30 +6,47 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.pull = pull;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const zlib_1 = require("zlib");
+const promises_1 = require("stream/promises");
+const stream_1 = require("stream");
+const tar_1 = require("tar");
 const axios_1 = __importDefault(require("axios"));
 const chalk_1 = __importDefault(require("chalk"));
-const adm_zip_1 = __importDefault(require("adm-zip"));
+const prompts_1 = __importDefault(require("prompts"));
 const api_1 = require("../utils/api");
-async function pull(projectName, destPath) {
+async function pull(projectName, destPath, options = {}) {
     const config = await (0, api_1.requireConfigWithWorkspace)();
     const destination = destPath ? path_1.default.resolve(destPath) : process.cwd();
+    // Warn if destination has existing files
+    if (fs_1.default.existsSync(destination)) {
+        const entries = fs_1.default.readdirSync(destination);
+        if (entries.length > 0 && !options.yes) {
+            console.log(chalk_1.default.yellow(`Destination "${destination}" is not empty (${entries.length} items).`));
+            console.log(chalk_1.default.yellow('Pulling will overwrite existing files.'));
+            const response = await (0, prompts_1.default)({
+                type: 'confirm',
+                name: 'proceed',
+                message: 'Continue?',
+                initial: false,
+            });
+            if (!response.proceed) {
+                console.log(chalk_1.default.gray('Cancelled.'));
+                process.exit(0);
+            }
+        }
+    }
     console.log(chalk_1.default.blue(`Pulling project "${projectName}"...`));
     try {
         const response = await axios_1.default.get(`${config.host}/api/v1/projects/${projectName}/source`, {
             headers: { ...(0, api_1.getApiHeaders)(config), 'Accept': 'application/octet-stream' },
             responseType: 'arraybuffer',
         });
-        const zipBuffer = Buffer.from(response.data);
-        const tempZipPath = path_1.default.join(destination, '.steps-pull-temp.zip');
-        // Write the zip to a temp file
-        fs_1.default.writeFileSync(tempZipPath, zipBuffer);
-        console.log(chalk_1.default.gray(`Downloaded ${zipBuffer.length} bytes`));
+        const buffer = Buffer.from(response.data);
+        console.log(chalk_1.default.gray(`Downloaded ${buffer.length} bytes`));
         console.log(chalk_1.default.yellow(`Extracting to ${destination}...`));
-        // Extract the zip
-        const zip = new adm_zip_1.default(tempZipPath);
-        zip.extractAllTo(destination, true);
-        // Clean up temp file
-        fs_1.default.unlinkSync(tempZipPath);
+        fs_1.default.mkdirSync(destination, { recursive: true });
+        const readable = stream_1.Readable.from(buffer);
+        await (0, promises_1.pipeline)(readable, (0, zlib_1.createGunzip)(), (0, tar_1.extract)({ cwd: destination, strip: 0 }));
         console.log(chalk_1.default.green(`Project "${projectName}" pulled successfully!`));
     }
     catch (error) {

package/dist/commands/run-list.js

@@ -0,0 +1,186 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runs = runs;
+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)
+    const defaultLimit = options.detailed ? 5 : 20;
+    const limit = options.limit || defaultLimit;
+    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';
+        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;
+        if (!runsList || runsList.length === 0) {
+            if (options.json) {
+                console.log('[]');
+            }
+            else {
+                console.log(chalk_1.default.gray('No runs found.'));
+            }
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(runsList, null, 2));
+            return;
+        }
+        // Human-readable output
+        if (options.detailed) {
+            displayDetailedList(runsList, projectName);
+        }
+        else {
+            displaySummaryTable(runsList, projectName);
+        }
+    }
+    catch (error) {
+        if (error.response) {
+            if (error.response.status === 401) {
+                console.error(chalk_1.default.red('Authentication failed. Run "solidactions init <api-key>" to re-configure.'));
+            }
+            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);
+    }
+}
+// ─── Display modes ─────────────────────────────────────────────────────────
+function displaySummaryTable(runsList, projectName) {
+    const header = projectName ? `Recent runs for "${projectName}":` : 'Recent runs:';
+    console.log(chalk_1.default.blue(header));
+    console.log('');
+    console.log(chalk_1.default.gray('ID'.padEnd(8) + 'WORKFLOW'.padEnd(25) + 'STATUS'.padEnd(12) + 'TRIGGERED'.padEnd(22) + 'TRIGGERED BY'));
+    console.log(chalk_1.default.gray('-'.repeat(90)));
+    for (const run of runsList) {
+        const id = String(run.id || '?').padEnd(8);
+        const workflow = truncate(run.workflow_name || '?', 24).padEnd(25);
+        const status = run.execution_status || run.status || '?';
+        const statusColor = getStatusColor(status);
+        const triggeredAt = run.triggered_at ? new Date(run.triggered_at).toLocaleString() : '-';
+        const triggeredBy = run.triggered_by || '-';
+        console.log(chalk_1.default.gray(id) +
+            workflow +
+            statusColor(status.padEnd(12)) +
+            chalk_1.default.gray(triggeredAt.padEnd(22)) +
+            chalk_1.default.gray(triggeredBy));
+    }
+    console.log('');
+    console.log(chalk_1.default.gray(`Showing ${runsList.length} run(s)`));
+}
+function displayDetailedList(runsList, projectName) {
+    const header = projectName ? `Runs for "${projectName}" (detailed):` : 'Runs (detailed):';
+    console.log(chalk_1.default.blue(header));
+    for (const run of runsList) {
+        const status = run.execution_status || run.status || '?';
+        const statusColor = getStatusColor(status);
+        const exitStr = run.exit_code !== null && run.exit_code !== undefined ? ` (exit ${run.exit_code})` : '';
+        console.log('');
+        console.log(chalk_1.default.bold(`  Run #${run.id}`) + chalk_1.default.gray(` — ${run.workflow_name || '?'} (${run.project_name || '?'})`));
+        console.log(`    Status:    ${statusColor(status)}${chalk_1.default.gray(exitStr)}`);
+        console.log(`    Trigger:   ${chalk_1.default.gray(run.triggered_by || '-')}`);
+        // Timeline
+        if (run.timeline) {
+            const formatTs = (iso) => iso ? new Date(iso).toLocaleString() : '-';
+            console.log(`    Triggered: ${chalk_1.default.gray(formatTs(run.timeline.triggered))}`);
+            console.log(`    Started:   ${chalk_1.default.gray(formatTs(run.timeline.started))}`);
+            console.log(`    Completed: ${chalk_1.default.gray(formatTs(run.timeline.completed))}`);
+        }
+        // Steps summary
+        if (run.steps && run.steps.length > 0) {
+            const completed = run.steps.filter((s) => s.completed_at || s.completed_at_epoch_ms).length;
+            const totalDuration = run.steps.reduce((sum, s) => sum + (s.duration_ms || 0), 0);
+            console.log(`    Steps:     ${chalk_1.default.gray(`${completed}/${run.steps.length} completed (${formatDuration(totalDuration)} total)`)}`);
+        }
+        // Logs snippet (first errors or last 3 lines)
+        if (run.logs && typeof run.logs === 'string' && run.logs.trim()) {
+            const lines = run.logs.trim().split('\n');
+            const errorLines = lines.filter((l) => /error|fail|exception/i.test(l));
+            if (errorLines.length > 0) {
+                console.log(`    Errors:`);
+                for (const line of errorLines.slice(0, 3)) {
+                    console.log(chalk_1.default.red(`      ${truncate(line, 80)}`));
+                }
+            }
+        }
+    }
+    console.log('');
+    console.log(chalk_1.default.gray(`Showing ${runsList.length} run(s)`));
+}
+// ─── Utility ───────────────────────────────────────────────────────────────
+/**
+ * Parse --since value into epoch ms.
+ * Accepts: "1h", "30m", "2d", "1w", or ISO date string.
+ */
+function parseSince(since) {
+    const match = since.match(/^(\d+)(m|h|d|w)$/);
+    if (match) {
+        const value = parseInt(match[1]);
+        const unit = match[2];
+        const multipliers = {
+            m: 60 * 1000,
+            h: 60 * 60 * 1000,
+            d: 24 * 60 * 60 * 1000,
+            w: 7 * 24 * 60 * 60 * 1000,
+        };
+        const ms = Date.now() - (value * multipliers[unit]);
+        return String(ms);
+    }
+    // Assume ISO date string — let the backend parse it
+    return since;
+}
+function formatDuration(ms) {
+    if (ms === null || ms === undefined)
+        return '-';
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    if (ms < 3600000)
+        return `${Math.round(ms / 60000)}m`;
+    return `${Math.round(ms / 3600000)}h`;
+}
+function truncate(str, max) {
+    if (str.length <= max)
+        return str;
+    return str.substring(0, max - 3) + '...';
+}
+function getStatusColor(status) {
+    switch (status?.toLowerCase()) {
+        case 'completed':
+        case 'success':
+            return chalk_1.default.green;
+        case 'running':
+            return chalk_1.default.blue;
+        case 'pending':
+        case 'queued':
+            return chalk_1.default.yellow;
+        case 'failed':
+        case 'error':
+            return chalk_1.default.red;
+        default:
+            return chalk_1.default.gray;
+    }
+}