@solidactions/cli 0.7.3 → 1.0.0

package/dist/index.js

@@ -4,12 +4,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const deploy_1 = require("./commands/deploy");
 const init_1 = require("./commands/init");
-const logs_1 = require("./commands/logs");
-const logs_build_1 = require("./commands/logs-build");
-const steps_1 = require("./commands/steps");
-const run_1 = require("./commands/run");
-const runs_1 = require("./commands/runs");
 const pull_1 = require("./commands/pull");
+const project_list_1 = require("./commands/project-list");
+const project_logs_1 = require("./commands/project-logs");
+const run_start_1 = require("./commands/run-start");
+const run_list_1 = require("./commands/run-list");
+const run_view_1 = require("./commands/run-view");
 const env_list_1 = require("./commands/env-list");
 const env_delete_1 = require("./commands/env-delete");
 const env_map_1 = require("./commands/env-map");
@@ -19,7 +19,7 @@ const env_set_1 = require("./commands/env-set");
 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 webhooks_1 = require("./commands/webhooks");
+const webhook_list_1 = require("./commands/webhook-list");
 const dev_1 = require("./commands/dev");
 const ai_init_1 = require("./commands/ai-init");
 const ai_examples_1 = require("./commands/ai-examples");
@@ -32,7 +32,7 @@ program
     .description('SolidActions CLI - Deploy and manage workflow automation')
     .version(pkg.version);
 // =============================================================================
-// Authentication & Configuration
+// Top-level commands
 // =============================================================================
 program
     .command('init')
@@ -56,90 +56,97 @@ program
     .action(() => {
     (0, init_1.whoami)();
 });
+program
+    .command('dev')
+    .description('Run a workflow locally using an in-memory mock server (no deploy needed)')
+    .argument('<file>', 'Workflow file to run (e.g., src/simple-steps.ts)')
+    .option('-i, --input <json>', 'JSON input for the workflow', '{}')
+    .action((file, options) => {
+    (0, dev_1.dev)(file, options);
+});
 // =============================================================================
-// Project Management
+// project <subcommand>
 // =============================================================================
-program
+const project = program.command('project').description('Manage projects');
+project
     .command('deploy')
     .description('Deploy a project to SolidActions')
     .argument('<project-name>', 'Project name (will be created if it doesn\'t exist)')
     .argument('[path]', 'Source directory to deploy (defaults to current directory)')
     .option('-e, --env <environment>', 'Target environment (production/staging/dev)', 'dev')
     .option('--create', 'Create environment project if it doesn\'t exist')
+    .option('--config-only', 'Sync YAML env declarations without building/deploying')
     .action((projectName, path, options) => {
     (0, deploy_1.deploy)(projectName, path, options);
 });
-program
+project
     .command('pull')
     .description('Pull project source from SolidActions')
     .argument('<project-name>', 'Project name')
     .argument('[path]', 'Destination directory (defaults to current directory)')
-    .action((projectName, path) => {
-    (0, pull_1.pull)(projectName, path);
+    .option('-y, --yes', 'Skip overwrite confirmation')
+    .action((projectName, path, options) => {
+    (0, pull_1.pull)(projectName, path, options);
+});
+project
+    .command('logs')
+    .description('View build/deployment logs for a project')
+    .argument('<project>', 'Project name')
+    .action((projectName) => {
+    (0, project_logs_1.logsBuild)(projectName);
+});
+project
+    .command('list')
+    .description('List all projects')
+    .action(() => {
+    (0, project_list_1.projectList)();
 });
 // =============================================================================
-// Workflow Execution
+// run <subcommand>
 // =============================================================================
-program
-    .command('run')
+const runCmd = program.command('run').description('Manage workflow runs');
+runCmd
+    .command('start')
     .description('Trigger a workflow run')
     .argument('<project>', 'Project name')
     .argument('<workflow>', 'Workflow name')
     .option('-e, --env <environment>', 'Environment (production/staging/dev)', 'dev')
     .option('-i, --input <json>', 'JSON input for the workflow')
     .option('-w, --wait', 'Wait for the workflow to complete')
-    .action((project, workflow, options) => {
-    (0, run_1.run)(project, workflow, options);
+    .action((projectName, workflow, options) => {
+    (0, run_start_1.run)(projectName, workflow, options);
 });
-program
-    .command('runs')
+runCmd
+    .command('list')
     .description('List recent workflow runs')
     .argument('[project]', 'Filter by project name')
     .option('-l, --limit <number>', 'Number of runs to show', parseInt)
-    .action((project, options) => {
-    (0, runs_1.runs)(project, options);
-});
-program
-    .command('dev')
-    .description('Run a workflow locally using an in-memory mock server (no deploy needed)')
-    .argument('<file>', 'Workflow file to run (e.g., src/simple-steps.ts)')
-    .option('-i, --input <json>', 'JSON input for the workflow', '{}')
-    .action((file, options) => {
-    (0, dev_1.dev)(file, options);
-});
-// =============================================================================
-// Logs
-// =============================================================================
-program
-    .command('logs')
-    .description('View logs for a workflow run')
-    .argument('<run-id>', 'Run ID')
-    .option('-f, --follow', 'Follow log output (tail -f style)')
-    .action((runId, options) => {
-    (0, logs_1.logs)(runId, options);
-});
-program
-    .command('logs:build')
-    .description('View build/deployment logs for a project')
-    .argument('<project>', 'Project name')
-    .action((project) => {
-    (0, logs_build_1.logsBuild)(project);
+    .option('--offset <number>', 'Skip first N runs (pagination)', parseInt)
+    .option('--status <status>', 'Filter by status (completed, failed, queued, running)')
+    .option('--since <duration>', 'Filter to runs since (e.g., 1h, 30m, 2d, 1w)')
+    .option('--workflow <name>', 'Filter by workflow name')
+    .option('--detailed', 'Include timeline, steps, and logs per run (default limit: 5)')
+    .option('--json', 'Output as JSON')
+    .action((projectName, options) => {
+    (0, run_list_1.runs)(projectName, options);
 });
-program
-    .command('steps')
-    .description('View step outputs and timing for a workflow run')
+runCmd
+    .command('view')
+    .description('View details, timeline, steps, or logs for a workflow run')
     .argument('<run-id>', 'Run ID')
-    .option('-s, --step <name>', 'Show output for a specific step')
-    .option('--json', 'Output as JSON (for piping/redirection)')
-    .option('-f, --follow', 'Follow step progress for in-progress runs')
+    .option('--timeline', 'Show only timeline data')
+    .option('--steps', 'Show only step data')
+    .option('--logs', 'Show raw logs')
+    .option('--json', 'Output as JSON')
     .action((runId, options) => {
-    (0, steps_1.steps)(runId, options);
+    (0, run_view_1.runView)(runId, options);
 });
 // =============================================================================
-// Environment Variables
+// env <subcommand>
 // =============================================================================
-program
-    .command('env:set')
+const env = program.command('env').description('Manage environment variables');
+env
+    .command('set')
     .description('Set an environment variable (create or update, global or project)')
     .argument('<key-or-project>', 'Variable key (global) or project name')
     .argument('<value-or-key>', 'Variable value (global) or variable key (project)')
@@ -151,19 +158,20 @@ program
     .option('--staging-inherit', 'Staging inherits from production (global only)')
     .option('--dev-inherit', 'Dev inherits from production (global only)')
     .option('--dev-inherit-staging', 'Dev inherits from staging (global only)')
+    .option('-y, --yes', 'Skip overwrite confirmation')
     .action((keyOrProject, valueOrKey, value, options) => {
     (0, env_set_1.envSet)(keyOrProject, valueOrKey, value, options);
 });
-program
-    .command('env:list')
+env
+    .command('list')
     .description('List environment variables')
     .argument('[project]', 'Project name (omit for global variables)')
     .option('-e, --env <environment>', 'Filter by environment (production/staging/dev)')
-    .action((project, options) => {
-    (0, env_list_1.envList)(project, options);
+    .action((projectName, options) => {
+    (0, env_list_1.envList)(projectName, options);
 });
-program
-    .command('env:delete')
+env
+    .command('delete')
     .description('Delete an environment variable')
     .argument('<key-or-project>', 'Variable key (global) or project name')
     .argument('[key]', 'Variable key (if first arg is project)')
@@ -171,28 +179,29 @@ program
     .action((keyOrProject, key, options) => {
     (0, env_delete_1.envDelete)(keyOrProject, key, options);
 });
-program
-    .command('env:map')
+env
+    .command('map')
     .description('Map a global variable to a project-specific key')
     .argument('<project>', 'Project name')
     .argument('<key>', 'Project-specific variable name')
     .argument('<global-key>', 'Global variable name to map from')
-    .action((project, key, globalKey) => {
-    (0, env_map_1.envMap)(project, key, globalKey);
+    .option('-y, --yes', 'Skip overwrite confirmation')
+    .action((projectName, key, globalKey, options) => {
+    (0, env_map_1.envMap)(projectName, key, globalKey, options);
 });
-program
-    .command('env:pull')
+env
+    .command('pull')
     .description('Pull resolved environment variables to a local file')
     .argument('<project>', 'Project name')
     .option('-e, --env <environment>', 'Environment (production/staging/dev)', 'dev')
     .option('-o, --output <file>', 'Output file path (defaults to .env or .env.{environment})')
     .option('-y, --yes', 'Skip confirmation for secrets')
     .option('--update-oauth', 'Only pull OAuth tokens and merge into existing .env file')
-    .action((project, options) => {
-    (0, env_pull_1.envPull)(project, options);
+    .action((projectName, options) => {
+    (0, env_pull_1.envPull)(projectName, options);
 });
-program
-    .command('env:push')
+env
+    .command('push')
     .description('Push environment variables from .env file to a project')
     .argument('<project>', 'Project name')
     .argument('[path]', 'Source directory with solidactions.yaml and .env file', '.')
@@ -200,77 +209,82 @@ program
     .option('--new-only', 'Only push new or empty variables (skip existing)')
     .option('--include-undeclared', 'Also push vars not declared in solidactions.yaml')
     .option('-y, --yes', 'Skip confirmation prompt')
-    .action((project, path, options) => {
-    (0, env_push_1.envPush)(project, path, options);
+    .action((projectName, path, options) => {
+    (0, env_push_1.envPush)(projectName, path, options);
 });
 // =============================================================================
-// Scheduling
+// schedule <subcommand>
 // =============================================================================
-program
-    .command('schedule:set')
+const schedule = program.command('schedule').description('Manage cron schedules');
+schedule
+    .command('set')
     .description('Set a cron schedule for a workflow')
     .argument('<project>', 'Project name')
     .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')
-    .action((project, cron, options) => {
-    (0, schedule_set_1.scheduleSet)(project, cron, options);
+    .option('-y, --yes', 'Skip confirmation if schedule already exists')
+    .action((projectName, cron, options) => {
+    (0, schedule_set_1.scheduleSet)(projectName, cron, options);
 });
-program
-    .command('schedule:list')
+schedule
+    .command('list')
     .description('List schedules for a project')
     .argument('<project>', 'Project name')
-    .action((project) => {
-    (0, schedule_list_1.scheduleList)(project);
+    .action((projectName) => {
+    (0, schedule_list_1.scheduleList)(projectName);
 });
-program
-    .command('schedule:delete')
+schedule
+    .command('delete')
     .description('Delete a schedule')
     .argument('<project>', 'Project name')
     .argument('<schedule-id>', 'Schedule ID')
     .option('-y, --yes', 'Skip confirmation prompt')
-    .action((project, scheduleId, options) => {
-    (0, schedule_delete_1.scheduleDelete)(project, scheduleId, options);
+    .action((projectName, scheduleId, options) => {
+    (0, schedule_delete_1.scheduleDelete)(projectName, scheduleId, options);
 });
 // =============================================================================
-// Webhooks
+// webhook <subcommand>
 // =============================================================================
-program
-    .command('webhooks')
+const webhook = program.command('webhook').description('Manage webhooks');
+webhook
+    .command('list')
     .description('List webhook URLs for a project')
     .argument('<project>', 'Project name')
     .option('-e, --env <environment>', 'Environment (production/staging/dev)')
     .option('--show-secrets', 'Show webhook secrets')
-    .action((project, options) => {
-    (0, webhooks_1.webhookList)(project, options);
+    .action((projectName, options) => {
+    (0, webhook_list_1.webhookList)(projectName, options);
 });
 // =============================================================================
-// Workspaces
+// workspace <subcommand>
 // =============================================================================
-program
-    .command('workspaces')
+const workspace = program.command('workspace').description('Manage workspaces');
+workspace
+    .command('list')
     .description('List your workspaces across all organizations')
     .action(() => {
     (0, workspaces_1.workspacesList)();
 });
-program
-    .command('workspace:set')
+workspace
+    .command('set')
     .description('Set the active workspace for CLI operations')
     .argument('<workspace-id>', 'Workspace ID, slug, or name')
     .action((workspaceId) => {
     (0, workspaces_1.workspaceSet)(workspaceId);
 });
 // =============================================================================
-// AI Helper
+// ai <subcommand>
 // =============================================================================
-program
-    .command('ai:init')
+const ai = program.command('ai').description('AI helper tools');
+ai
+    .command('init')
     .description('Install AI helper documentation (CLAUDE.md or AGENTS.md) for AI-assisted workflow development')
     .option('--claude', 'Use CLAUDE.md (for Claude Code)')
     .option('--agents', 'Use AGENTS.md (for Cursor, Windsurf, etc.)')
     .action((options) => { (0, ai_init_1.aiInit)(options); });
-program
-    .command('ai:examples')
+ai
+    .command('examples')
     .description('Install example workflows for AI reference')
     .argument('[names...]', 'Example names to install (omit for interactive selector)')
     .option('--all', 'Install all available examples')

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@solidactions/cli",
-    "version": "0.7.3",
+    "version": "1.0.0",
     "description": "SolidActions CLI - Deploy and manage workflow automation",
     "main": "dist/index.js",
     "bin": {
@@ -36,7 +36,6 @@
         "prepublishOnly": "npm run build"
     },
     "dependencies": {
-        "adm-zip": "^0.5.16",
         "archiver": "^7.0.0",
         "axios": "^1.6.0",
         "chalk": "^4.1.2",
@@ -45,15 +44,16 @@
         "form-data": "^4.0.0",
         "fs-extra": "^11.0.0",
         "js-yaml": "^4.1.0",
-        "prompts": "^2.4.2"
+        "prompts": "^2.4.2",
+        "tar": "^7.5.12"
     },
     "devDependencies": {
-        "@types/adm-zip": "^0.5.7",
         "@types/archiver": "^6.0.0",
         "@types/fs-extra": "^11.0.0",
         "@types/js-yaml": "^4.0.9",
         "@types/node": "^20.0.0",
         "@types/prompts": "^2.4.9",
+        "@types/tar": "^6.1.13",
         "typescript": "^5.0.0"
     }
 }

package/dist/commands/logs.js

@@ -1,103 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.logs = logs;
-const axios_1 = __importDefault(require("axios"));
-const chalk_1 = __importDefault(require("chalk"));
-const api_1 = require("../utils/api");
-async function logs(runId, options) {
-    const config = await (0, api_1.requireConfigWithWorkspace)();
-    console.log(chalk_1.default.blue(`Fetching logs for run: ${runId}...`));
-    try {
-        // Get the run status first
-        const runResponse = await axios_1.default.get(`${config.host}/api/v1/runs/${runId}`, {
-            headers: (0, api_1.getApiHeaders)(config),
-        });
-        const runData = runResponse.data;
-        console.log(chalk_1.default.gray(`Status: ${runData.status}`));
-        console.log(chalk_1.default.gray('---'));
-        // Get the logs for this run
-        const logsResponse = await axios_1.default.get(`${config.host}/api/v1/runs/${runId}/logs`, {
-            headers: (0, api_1.getApiHeaders)(config),
-        });
-        const errors = logsResponse.data.errors || [];
-        if (errors.length > 0) {
-            for (const err of errors) {
-                console.log(chalk_1.default.red(`Worker ${err.worker}: ${err.error}`));
-            }
-            console.log(chalk_1.default.gray('---'));
-        }
-        const logData = logsResponse.data.logs || '';
-        let printed = displayLogs(logData);
-        if (options.follow && runData.status === 'running') {
-            console.log(chalk_1.default.gray('\n--- Following logs (Ctrl+C to stop) ---\n'));
-            const pollInterval = setInterval(async () => {
-                try {
-                    const refreshResponse = await axios_1.default.get(`${config.host}/api/v1/runs/${runId}/logs`, {
-                        headers: (0, api_1.getApiHeaders)(config),
-                    });
-                    const newLogData = refreshResponse.data.logs || '';
-                    if (newLogData.length > printed) {
-                        const newContent = newLogData.substring(printed);
-                        printed += displayLogs(newContent);
-                    }
-                    // Check if run is complete
-                    const runStatus = await axios_1.default.get(`${config.host}/api/v1/runs/${runId}`, {
-                        headers: (0, api_1.getApiHeaders)(config),
-                    });
-                    if (['completed', 'failed', 'acknowledged'].includes(runStatus.data.status)) {
-                        clearInterval(pollInterval);
-                        console.log(chalk_1.default.gray(`\n--- Run ${runStatus.data.status} ---`));
-                        process.exit(runStatus.data.status === 'completed' ? 0 : 1);
-                    }
-                }
-                catch {
-                    // Ignore transient errors during follow
-                }
-            }, 2000);
-        }
-    }
-    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 if (error.response.status === 404) {
-                console.error(chalk_1.default.red('Run 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);
-    }
-}
-/**
- * Display log content. Handles both string logs and array-of-entry logs.
- * Returns the number of characters printed (for follow-mode diffing).
- */
-function displayLogs(logData) {
-    if (typeof logData === 'string') {
-        if (logData.trim()) {
-            console.log(logData);
-        }
-        return logData.length;
-    }
-    // Handle array format in case the API changes
-    for (const entry of logData) {
-        const message = entry.message || entry.content || '';
-        if (!message.trim())
-            continue;
-        const timestamp = entry.timestamp ? new Date(entry.timestamp).toLocaleTimeString() : '??:??:??';
-        const stream = entry.stream || 'stdout';
-        const streamIndicator = stream === 'stderr' ? chalk_1.default.red('[err]') : chalk_1.default.gray('[out]');
-        const coloredMessage = stream === 'stderr' ? chalk_1.default.red(message) : chalk_1.default.white(message);
-        console.log(`${chalk_1.default.gray(`[${timestamp}]`)} ${streamIndicator} ${coloredMessage}`);
-    }
-    return logData.length;
-}

package/dist/commands/runs.js

@@ -1,90 +0,0 @@
-"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)();
-    const limit = options.limit || 20;
-    console.log(chalk_1.default.blue(projectName ? `Recent runs for "${projectName}":` : 'Recent runs:'));
-    try {
-        const params = { limit };
-        if (projectName) {
-            params.project = projectName;
-        }
-        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) {
-            console.log(chalk_1.default.gray('No runs found.'));
-            return;
-        }
-        console.log('');
-        console.log(chalk_1.default.gray('ID'.padEnd(38) + 'WORKFLOW'.padEnd(25) + 'STATUS'.padEnd(12) + 'STARTED'.padEnd(22) + 'DURATION'));
-        console.log(chalk_1.default.gray('-'.repeat(110)));
-        for (const run of runsList) {
-            const id = run.id || '?';
-            const workflow = run.workflow?.name || run.workflow_name || '?';
-            const status = run.status || '?';
-            const startedAt = run.started_at ? new Date(run.started_at).toLocaleString() : '-';
-            const duration = calculateDuration(run.started_at, run.completed_at);
-            const statusColor = getStatusColor(status);
-            console.log(chalk_1.default.gray(id.toString().padEnd(38)) +
-                workflow.padEnd(25) +
-                statusColor(status.padEnd(12)) +
-                chalk_1.default.gray(startedAt.padEnd(22)) +
-                chalk_1.default.gray(duration));
-        }
-        console.log('');
-        console.log(chalk_1.default.gray(`Showing ${runsList.length} run(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);
-    }
-}
-function calculateDuration(startedAt, completedAt) {
-    if (!startedAt)
-        return '-';
-    const start = new Date(startedAt).getTime();
-    const end = completedAt ? new Date(completedAt).getTime() : Date.now();
-    const durationMs = end - start;
-    if (durationMs < 1000)
-        return `${durationMs}ms`;
-    if (durationMs < 60000)
-        return `${Math.round(durationMs / 1000)}s`;
-    if (durationMs < 3600000)
-        return `${Math.round(durationMs / 60000)}m`;
-    return `${Math.round(durationMs / 3600000)}h`;
-}
-function getStatusColor(status) {
-    switch (status.toLowerCase()) {
-        case 'completed':
-            return chalk_1.default.green;
-        case 'running':
-            return chalk_1.default.blue;
-        case 'pending':
-        case 'queued':
-            return chalk_1.default.yellow;
-        case 'failed':
-            return chalk_1.default.red;
-        default:
-            return chalk_1.default.gray;
-    }
-}