@eve-horizon/cli 0.1.3 → 0.1.4

package/dist/commands/auth.js

@@ -260,6 +260,17 @@ async function handleAuth(subcommand, flags, context, credentials) {
             (0, output_1.outputJson)({ profile: context.profileName, user_id: payload.user_id, token_type: payload.token_type }, json, `✓ Bootstrapped admin user (user_id: ${payload.user_id})`);
             return;
         }
+        case 'token': {
+            // Print the current access token to stdout for use in scripts
+            const tokenEntry = credentials.profiles[context.profileName];
+            if (!tokenEntry || !tokenEntry.access_token) {
+                console.error('No valid token found. Please login first with: eve auth login');
+                process.exit(1);
+            }
+            // Print only the token to stdout, nothing else
+            console.log(tokenEntry.access_token);
+            return;
+        }
         case 'sync': {
             const claudeOnly = (0, args_1.getBooleanFlag)(flags, ['claude']) ?? false;
             const codexOnly = (0, args_1.getBooleanFlag)(flags, ['codex']) ?? false;
@@ -384,7 +395,7 @@ async function handleAuth(subcommand, flags, context, credentials) {
             return;
         }
         default:
-            throw new Error('Usage: eve auth <login|logout|status|whoami|bootstrap|sync>');
+            throw new Error('Usage: eve auth <login|logout|status|whoami|bootstrap|sync|token>');
     }
 }
 function signNonceWithSsh(keyPath, nonce) {

package/dist/commands/env.js

@@ -1,10 +1,44 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleEnv = handleEnv;
 const args_1 = require("../lib/args");
 const client_1 = require("../lib/client");
 const output_1 = require("../lib/output");
 const child_process_1 = require("child_process");
+const readline = __importStar(require("node:readline/promises"));
 // ============================================================================
 // Main Handler
 // ============================================================================
@@ -21,13 +55,16 @@ async function handleEnv(subcommand, positionals, flags, context) {
             return handleDeploy(positionals, flags, context, json);
         case 'logs':
             return handleLogs(positionals, flags, context, json);
+        case 'delete':
+            return handleDelete(positionals, flags, context, json);
         default:
-            throw new Error('Usage: eve env <list|show|create|deploy|logs>\n' +
+            throw new Error('Usage: eve env <list|show|create|deploy|logs|delete>\n' +
                 '  list [project]                          - list environments for a project\n' +
                 '  show <project> <name>                   - show details of an environment\n' +
                 '  create <name> --type=<type> [options]   - create an environment\n' +
-                '  deploy <project> <name> [--tag=<tag>] [--release-tag=<tag>]   - deploy to an environment\n' +
-                '  logs <project> <env> <service> [--since <seconds>] [--tail <n>] [--grep <text>] - get service logs');
+                '  deploy <env> --ref <sha> [--direct] [--inputs <json>]   - deploy to an environment\n' +
+                '  logs <project> <env> <service> [--since <seconds>] [--tail <n>] [--grep <text>] - get service logs\n' +
+                '  delete <name> [--project=<id>] [--force] - delete an environment');
     }
 }
 // ============================================================================
@@ -120,9 +157,9 @@ async function handleCreate(positionals, flags, context, json) {
     }
 }
 /**
- * eve env deploy [project] <name>
+ * eve env deploy [project] <name> --ref <sha> [--direct] [--inputs <json>]
  * Deploy to an environment
- * If project is in profile, can use: eve env deploy <name>
+ * If project is in profile, can use: eve env deploy <name> --ref <sha>
  */
 async function handleDeploy(positionals, flags, context, json) {
     // Smart positional parsing:
@@ -153,42 +190,48 @@ async function handleDeploy(positionals, flags, context, json) {
         envName = flagName;
     }
     if (!projectId || !envName) {
-        throw new Error('Usage: eve env deploy [project] <name> [--tag=<tag>] [--release-tag=<tag>] [--project=<id>]');
-    }
-    // Get git SHA from current directory
-    const releaseTag = (0, args_1.getStringFlag)(flags, ['release-tag', 'release_tag']);
-    let gitSha = null;
-    let manifest = null;
-    if (!releaseTag) {
-        gitSha = getGitSha();
-        if (!gitSha) {
-            throw new Error('Failed to get git SHA. Are you in a git repository?');
+        throw new Error('Usage: eve env deploy <env> --ref <sha> [--direct] [--inputs <json>] [--project=<id>]');
+    }
+    // --ref flag is now required
+    const gitSha = (0, args_1.getStringFlag)(flags, ['ref']);
+    if (!gitSha) {
+        throw new Error('Usage: eve env deploy <env> --ref <sha> [options]\n\nThe --ref flag is required (git SHA or commit reference)');
+    }
+    if (!json) {
+        console.log(`Deploying commit ${gitSha.substring(0, 8)} to ${envName}...`);
+    }
+    // Get manifest hash from server
+    const manifest = await (0, client_1.requestJson)(context, `/projects/${projectId}/manifest`);
+    if (!json) {
+        console.log(`Using manifest ${manifest.manifest_hash.substring(0, 8)}...`);
+    }
+    // Parse --direct flag (optional boolean)
+    const direct = Boolean(flags.direct);
+    // Parse --inputs flag (optional JSON)
+    let inputs;
+    const inputsString = (0, args_1.getStringFlag)(flags, ['inputs']);
+    if (inputsString) {
+        try {
+            inputs = JSON.parse(inputsString);
+            if (typeof inputs !== 'object' || inputs === null || Array.isArray(inputs)) {
+                throw new Error('Inputs must be a JSON object');
+            }
         }
-        if (!json) {
-            console.log(`Deploying commit ${gitSha.substring(0, 8)} to ${envName}...`);
+        catch (error) {
+            throw new Error(`Failed to parse --inputs JSON: ${error instanceof Error ? error.message : String(error)}\n` +
+                'Example: --inputs \'{"release_id":"rel_xxx","smoke_test":false}\'');
         }
-        // Get manifest hash from server
-        manifest = await (0, client_1.requestJson)(context, `/projects/${projectId}/manifest`);
-        if (!json) {
-            console.log(`Using manifest ${manifest.manifest_hash.substring(0, 8)}...`);
-        }
-    }
-    else if (!json) {
-        console.log(`Deploying release tag ${releaseTag} to ${envName}...`);
     }
-    // Get optional image tag for local testing
-    const imageTag = (0, args_1.getStringFlag)(flags, ['tag']);
     // POST deployment
-    const body = {};
-    if (releaseTag) {
-        body.release_tag = releaseTag;
-    }
-    else if (gitSha && manifest) {
-        body.git_sha = gitSha;
-        body.manifest_hash = manifest.manifest_hash;
+    const body = {
+        git_sha: gitSha,
+        manifest_hash: manifest.manifest_hash,
+    };
+    if (direct) {
+        body.direct = true;
     }
-    if (imageTag) {
-        body.image_tag = imageTag;
+    if (inputs) {
+        body.inputs = inputs;
     }
     const response = await (0, client_1.requestJson)(context, `/projects/${projectId}/envs/${envName}/deploy`, {
         method: 'POST',
@@ -234,6 +277,57 @@ async function handleLogs(positionals, flags, context, json) {
         console.log(`[${entry.timestamp}] ${entry.line}`);
     }
 }
+/**
+ * eve env delete <name> [--project=<id>] [--force]
+ * Delete an environment
+ */
+async function handleDelete(positionals, flags, context, json) {
+    const projectId = (0, args_1.getStringFlag)(flags, ['project']) ?? context.projectId;
+    const envName = positionals[0] ?? (0, args_1.getStringFlag)(flags, ['name']);
+    const force = Boolean(flags.force);
+    if (!projectId || !envName) {
+        throw new Error('Usage: eve env delete <name> [--project=<id>] [--force]');
+    }
+    // Prompt for confirmation unless --force is set
+    if (!force) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            const answer = await rl.question(`Are you sure you want to delete environment "${envName}"? [y/N]: `);
+            if (answer.toLowerCase() !== 'y' && answer.toLowerCase() !== 'yes') {
+                console.log('Deletion cancelled.');
+                return;
+            }
+        }
+        finally {
+            rl.close();
+        }
+    }
+    try {
+        await (0, client_1.requestJson)(context, `/projects/${projectId}/envs/${envName}`, {
+            method: 'DELETE',
+        });
+        if (json) {
+            (0, output_1.outputJson)({ success: true, environment: envName }, json);
+        }
+        else {
+            console.log(`Environment "${envName}" deleted successfully.`);
+        }
+    }
+    catch (error) {
+        const err = error;
+        const message = err.message;
+        // Handle specific error cases
+        if (message.includes('404')) {
+            throw new Error(`Environment "${envName}" not found in project ${projectId}`);
+        }
+        else if (message.includes('409')) {
+            throw new Error(`Cannot delete environment "${envName}": environment has active deployments or resources`);
+        }
+        else {
+            throw error;
+        }
+    }
+}
 // ============================================================================
 // Helper Functions
 // ============================================================================

package/dist/commands/harness.js

@@ -7,9 +7,14 @@ const output_1 = require("../lib/output");
 async function handleHarness(subcommand, positionals, flags, context) {
     const json = Boolean(flags.json);
     const includeCapabilities = (0, args_1.getBooleanFlag)(flags, ['capabilities']) ?? false;
+    const orgId = (0, args_1.getStringFlag)(flags, ['org']);
+    const projectId = (0, args_1.getStringFlag)(flags, ['project']);
+    // Build query params for scope-aware auth checks
+    const scopeParams = buildScopeParams(orgId, projectId);
     switch (subcommand) {
         case 'list': {
-            const response = await (0, client_1.requestJson)(context, '/harnesses');
+            const url = scopeParams ? `/harnesses?${scopeParams}` : '/harnesses';
+            const response = await (0, client_1.requestJson)(context, url);
             if (json) {
                 (0, output_1.outputJson)(response, json);
                 return;
@@ -21,7 +26,8 @@ async function handleHarness(subcommand, positionals, flags, context) {
             const name = positionals[0];
             if (!name)
                 throw new Error('Usage: eve harness get <name>');
-            const response = await (0, client_1.requestJson)(context, `/harnesses/${name}`);
+            const url = scopeParams ? `/harnesses/${name}?${scopeParams}` : `/harnesses/${name}`;
+            const response = await (0, client_1.requestJson)(context, url);
             if (json) {
                 (0, output_1.outputJson)(response, json);
                 return;
@@ -33,6 +39,14 @@ async function handleHarness(subcommand, positionals, flags, context) {
             throw new Error('Usage: eve harness <list|get>');
     }
 }
+function buildScopeParams(orgId, projectId) {
+    const params = new URLSearchParams();
+    if (projectId)
+        params.set('project_id', projectId);
+    else if (orgId)
+        params.set('org_id', orgId);
+    return params.toString() || null;
+}
 function renderHarnessList(harnesses, includeCapabilities) {
     if (includeCapabilities) {
         renderHarnessCapabilities(harnesses);

package/dist/commands/job.js

@@ -1735,6 +1735,14 @@ async function handleResult(positionals, flags, context) {
  * Format result as plain text (default)
  */
 function formatResultText(response) {
+    // Display preview URL if present in result_json.pipeline_output
+    if (response.resultJson) {
+        const pipelineOutput = response.resultJson.pipeline_output;
+        if (pipelineOutput?.deploy?.preview_url) {
+            console.log(`Preview: ${pipelineOutput.deploy.preview_url}`);
+            console.log('');
+        }
+    }
     if (response.resultText) {
         console.log(response.resultText);
     }
@@ -1746,6 +1754,12 @@ function formatResultText(response) {
  * Format result as JSON
  */
 function formatResultJson(response) {
+    // Extract preview URL if present in result_json.pipeline_output
+    let previewUrl;
+    if (response.resultJson) {
+        const pipelineOutput = response.resultJson.pipeline_output;
+        previewUrl = pipelineOutput?.deploy?.preview_url;
+    }
     const output = {
         success: response.status === 'succeeded',
         exitCode: response.exitCode,
@@ -1755,6 +1769,7 @@ function formatResultJson(response) {
         tokenUsage: response.tokenInput !== null || response.tokenOutput !== null
             ? { input: response.tokenInput, output: response.tokenOutput }
             : null,
+        ...(previewUrl ? { previewUrl } : {}),
     };
     console.log(JSON.stringify(output, null, 2));
 }
@@ -1774,6 +1789,13 @@ function formatResultFull(response) {
         const outputStr = response.tokenOutput !== null ? formatNumber(response.tokenOutput) : '0';
         console.log(`Tokens: ${inputStr} in / ${outputStr} out`);
     }
+    // Display preview URL if present in result_json.pipeline_output
+    if (response.resultJson) {
+        const pipelineOutput = response.resultJson.pipeline_output;
+        if (pipelineOutput?.deploy?.preview_url) {
+            console.log(`Preview: ${pipelineOutput.deploy.preview_url}`);
+        }
+    }
     console.log('');
     console.log('Result:');
     if (response.resultText) {

package/dist/commands/org.js

@@ -71,8 +71,16 @@ async function handleOrg(subcommand, positionals, flags, context) {
             (0, output_1.outputJson)(response, json);
             return;
         }
+        case 'delete': {
+            const orgId = positionals[0];
+            if (!orgId)
+                throw new Error('Usage: eve org delete <org_id> [--force]');
+            const response = await (0, client_1.requestJson)(context, `/orgs/${orgId}`, { method: 'PATCH', body: { deleted: true } });
+            (0, output_1.outputJson)(response, json, `✓ Organization deleted: ${orgId}`);
+            return;
+        }
         default:
-            throw new Error('Usage: eve org <ensure|list|get|update>');
+            throw new Error('Usage: eve org <ensure|list|get|update|delete>');
     }
 }
 function normalizeOrgId(raw) {

package/dist/commands/pipeline.js

@@ -108,6 +108,13 @@ function formatPipelineRunDetail(detail) {
     if (run.git_sha) {
         console.log(`Git SHA: ${run.git_sha}`);
     }
+    // Display preview URL if present in step_outputs
+    if ('step_outputs' in run && run.step_outputs) {
+        const deployOutput = run.step_outputs.deploy;
+        if (deployOutput?.preview_url) {
+            console.log(`Preview: ${deployOutput.preview_url}`);
+        }
+    }
     if (run.started_at) {
         console.log(`Started: ${run.started_at}`);
     }

package/dist/commands/release.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRelease = handleRelease;
+const client_1 = require("../lib/client");
+const output_1 = require("../lib/output");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+async function handleRelease(subcommand, positionals, flags, context) {
+    const json = Boolean(flags.json);
+    switch (subcommand) {
+        case 'resolve': {
+            const tag = positionals[0];
+            if (!tag) {
+                throw new Error('Usage: eve release resolve <tag> [--project <id>]');
+            }
+            // Determine project ID
+            let projectId = typeof flags.project === 'string' ? flags.project : context.projectId;
+            // If no project ID provided, try to detect from local .eve/manifest.yaml
+            if (!projectId) {
+                const dir = typeof flags.dir === 'string' ? flags.dir : process.cwd();
+                const manifestPath = (0, node_path_1.join)(dir, '.eve', 'manifest.yaml');
+                try {
+                    const yaml = (0, node_fs_1.readFileSync)(manifestPath, 'utf-8');
+                    const projectMatch = yaml.match(/^project:\s*(\S+)/m);
+                    if (projectMatch) {
+                        projectId = projectMatch[1];
+                    }
+                }
+                catch (error) {
+                    // Manifest file not found or not readable, continue without it
+                }
+            }
+            if (!projectId) {
+                throw new Error('Missing project id. Provide --project, set a profile default, or add "project: proj_xxx" to .eve/manifest.yaml');
+            }
+            // Call the API endpoint
+            try {
+                const release = await (0, client_1.requestJson)(context, `/projects/${projectId}/releases/by-tag/${encodeURIComponent(tag)}`);
+                if (json) {
+                    // Output full JSON
+                    (0, output_1.outputJson)(release, json);
+                }
+                else {
+                    // Human-readable format
+                    const displayTag = release.tag || tag;
+                    const displayVersion = release.version || 'N/A';
+                    const shortSha = release.git_sha.substring(0, 8);
+                    const shortHash = release.manifest_hash.substring(0, 12);
+                    console.log(`Release ${displayTag}`);
+                    console.log(`  ID:       ${release.id}`);
+                    console.log(`  SHA:      ${shortSha}...`);
+                    console.log(`  Manifest: ${shortHash}...`);
+                    console.log(`  Version:  ${displayVersion}`);
+                }
+            }
+            catch (error) {
+                // Enhance 404 errors with more context
+                if (error instanceof Error && error.message.includes('HTTP 404')) {
+                    throw new Error(`Release with tag "${tag}" not found for project ${projectId}\n\n` +
+                        `Make sure the release exists and the tag is correct.`);
+                }
+                throw error;
+            }
+            return;
+        }
+        default:
+            throw new Error('Usage: eve release <resolve>');
+    }
+}

package/dist/index.js

@@ -23,6 +23,7 @@ const skills_1 = require("./commands/skills");
 const admin_1 = require("./commands/admin");
 const agents_1 = require("./commands/agents");
 const init_1 = require("./commands/init");
+const release_1 = require("./commands/release");
 async function main() {
     const { flags, positionals } = (0, args_1.parseArgs)(process.argv.slice(2));
     const command = positionals[0];
@@ -103,6 +104,9 @@ async function main() {
             // init doesn't use subcommands - first positional is directory name
             await (0, init_1.handleInit)(subcommand ? [subcommand, ...rest] : rest, flags);
             return;
+        case 'release':
+            await (0, release_1.handleRelease)(subcommand, rest, flags, context);
+            return;
         default:
             (0, help_1.showMainHelp)();
     }

package/dist/lib/help.js

@@ -40,10 +40,16 @@ exports.HELP = {
                 description: 'Update organization',
                 usage: 'eve org update <org_id> [--name <name>] [--deleted <bool>]',
             },
+            delete: {
+                description: 'Soft-delete an organization',
+                usage: 'eve org delete <org_id>',
+                examples: ['eve org delete org_xxx'],
+            },
         },
         examples: [
             'eve org ensure "Acme Corp"',
             'eve org list --limit 20',
+            'eve org delete org_xxx',
         ],
     },
     project: {
@@ -101,13 +107,14 @@ exports.HELP = {
         },
     },
     secrets: {
-        description: 'Manage secrets at project/org/user scope. Values are never returned in plaintext.',
+        description: 'Manage secrets at system/org/user/project scope. Values are never returned in plaintext.',
         usage: 'eve secrets <subcommand> [options]',
         subcommands: {
             set: {
                 description: 'Create or update a secret value',
-                usage: 'eve secrets set <key> <value> [--project <id>|--org <id>|--user <id>] [--type <type>]',
+                usage: 'eve secrets set <key> <value> [--system|--project <id>|--org <id>|--user <id>] [--type <type>]',
                 options: [
+                    '--system             System scope (admin only)',
                     '--project <id>       Project ID (uses profile default)',
                     '--org <id>           Organization ID',
                     '--user <id>          User ID',
@@ -116,21 +123,43 @@ exports.HELP = {
             },
             list: {
                 description: 'List secrets (metadata only)',
-                usage: 'eve secrets list [--project <id>|--org <id>|--user <id>]',
+                usage: 'eve secrets list [--system|--project <id>|--org <id>|--user <id>]',
+                options: [
+                    '--system             System scope (admin only)',
+                    '--project <id>       Project ID (uses profile default)',
+                    '--org <id>           Organization ID',
+                    '--user <id>          User ID',
+                ],
             },
             show: {
                 description: 'Show a masked secret value',
-                usage: 'eve secrets show <key> [--project <id>|--org <id>|--user <id>]',
+                usage: 'eve secrets show <key> [--system|--project <id>|--org <id>|--user <id>]',
+                options: [
+                    '--system             System scope (admin only)',
+                    '--project <id>       Project ID (uses profile default)',
+                    '--org <id>           Organization ID',
+                    '--user <id>          User ID',
+                ],
             },
             delete: {
                 description: 'Delete a secret',
-                usage: 'eve secrets delete <key> [--project <id>|--org <id>|--user <id>]',
+                usage: 'eve secrets delete <key> [--system|--project <id>|--org <id>|--user <id>]',
+                options: [
+                    '--system             System scope (admin only)',
+                    '--project <id>       Project ID (uses profile default)',
+                    '--org <id>           Organization ID',
+                    '--user <id>          User ID',
+                ],
             },
             import: {
                 description: 'Import env entries from an env file',
-                usage: 'eve secrets import [--file <path>] [--project <id>|--org <id>|--user <id>]',
+                usage: 'eve secrets import [--file <path>] [--system|--project <id>|--org <id>|--user <id>]',
                 options: [
                     '--file <path>        Defaults to .env',
+                    '--system             System scope (admin only)',
+                    '--project <id>       Project ID (uses profile default)',
+                    '--org <id>           Organization ID',
+                    '--user <id>          User ID',
                 ],
             },
             validate: {
@@ -547,7 +576,7 @@ have to specify them on every command. Useful when working with multiple environ
     auth: {
         description: `Authenticate with Eve Horizon. Auth is optional for local development but required
 for cloud deployments. Credentials are stored per-profile.`,
-        usage: 'eve auth <login|logout|status|whoami|bootstrap|sync>',
+        usage: 'eve auth <login|logout|status|whoami|bootstrap|sync|token>',
         subcommands: {
             login: {
                 description: 'Login via GitHub SSH challenge (default) or Supabase (legacy)',
@@ -578,6 +607,20 @@ for cloud deployments. Credentials are stored per-profile.`,
                 description: 'Show current user info',
                 usage: 'eve auth whoami',
             },
+            token: {
+                description: 'Print the current access token to stdout for sharing with reviewers or use in scripts',
+                usage: 'eve auth token [--print]',
+                options: [
+                    '--print             Explicitly request token print (default behavior)',
+                ],
+                examples: [
+                    'eve auth token',
+                    'TOKEN=$(eve auth token)',
+                    'curl -H "Authorization: Bearer $(eve auth token)" https://api.example.com',
+                    'eve auth token | pbcopy  # Copy to clipboard',
+                    'eve auth token  # Share with reviewers for PR preview access',
+                ],
+            },
             bootstrap: {
                 description: 'Bootstrap the first admin user with flexible security modes',
                 usage: 'eve auth bootstrap --email <email> [--token <token>] [options]',
@@ -654,17 +697,19 @@ for cloud deployments. Credentials are stored per-profile.`,
             },
             deploy: {
                 description: 'Deploy to an environment',
-                usage: 'eve env deploy <project> <name> [--tag=<tag>] [--release-tag=<tag>]',
+                usage: 'eve env deploy <env> --ref <sha> [--direct] [--inputs <json>] [--project <id>]',
                 options: [
-                    '<project>             Project ID or slug',
-                    '<name>                Environment name (staging, production, test)',
-                    '--tag <tag>           Image tag (e.g., "local" for local images, "sha-abc" for CI)',
-                    '--release-tag <tag>   Deploy an existing release by tag (e.g., v1.2.3)',
+                    '<env>                  Environment name (staging, production, test)',
+                    '--ref <sha>            Git SHA or commit reference (required)',
+                    '--direct               Bypass pipeline and do direct deploy',
+                    '--inputs <json>        JSON inputs for the deployment (e.g., \'{"release_id":"rel_xxx"}\')',
+                    '--project <id>         Project ID or slug (uses profile default if omitted)',
                 ],
                 examples: [
-                    'eve env deploy proj_xxx staging',
-                    'eve env deploy my-project test --tag local',
-                    'eve env deploy proj_xxx staging --release-tag v1.2.3',
+                    'eve env deploy staging --ref abc123',
+                    'eve env deploy staging --ref abc123 --direct',
+                    'eve env deploy staging --ref abc123 --inputs \'{"release_id":"rel_xxx","smoke_test":false}\'',
+                    'eve env deploy staging --ref abc123 --direct --inputs \'{"release_id":"rel_xxx"}\'',
                 ],
             },
             logs: {
@@ -683,11 +728,25 @@ for cloud deployments. Credentials are stored per-profile.`,
                     'eve env logs proj_xxx staging api --since 3600 --grep ERROR',
                 ],
             },
+            delete: {
+                description: 'Delete an environment',
+                usage: 'eve env delete <name> [--project=<id>] [--force]',
+                options: [
+                    '<name>                Environment name to delete',
+                    '--project <id>        Project ID (uses profile default if omitted)',
+                    '--force               Skip confirmation prompt',
+                ],
+                examples: [
+                    'eve env delete test',
+                    'eve env delete staging --project=proj_xxx',
+                    'eve env delete old-env --force',
+                ],
+            },
         },
         examples: [
             'eve env list',
             'eve env create test --type=persistent',
-            'eve env deploy proj_xxx staging',
+            'eve env deploy staging --ref abc123',
             'eve env logs proj_xxx staging api --tail 200',
         ],
     },
@@ -953,6 +1012,30 @@ for cloud deployments. Credentials are stored per-profile.`,
             'eve admin invite --email user@example.com --github octocat --org org_xxx',
         ],
     },
+    release: {
+        description: 'Manage and inspect releases.',
+        usage: 'eve release <subcommand> [options]',
+        subcommands: {
+            resolve: {
+                description: 'Look up a release by tag and output its details',
+                usage: 'eve release resolve <tag> [--project <id>]',
+                options: [
+                    '<tag>                Release tag (e.g., v1.2.3)',
+                    '--project <id>       Project ID (uses profile default or .eve/manifest.yaml if omitted)',
+                    '--json               Output as JSON',
+                ],
+                examples: [
+                    'eve release resolve v1.2.3',
+                    'eve release resolve v1.2.3 --project proj_xxx',
+                    'eve release resolve v1.2.3 --json',
+                ],
+            },
+        },
+        examples: [
+            'eve release resolve v1.2.3',
+            'eve release resolve v1.2.3 --json',
+        ],
+    },
     init: {
         description: `Initialize a new Eve Horizon project from a template.
 
@@ -1081,6 +1164,7 @@ function showMainHelp() {
     console.log('  project    Manage projects');
     console.log('  job        Manage jobs (create, list, show, update, claim, etc.)');
     console.log('  env        Manage environments (list, show, deploy)');
+    console.log('  release    Manage and inspect releases');
     console.log('  api        Explore API sources and call endpoints');
     console.log('  db         Inspect env DB schema, RLS, and SQL');
     console.log('  pipeline   Inspect manifest pipelines (list, show)');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eve-horizon/cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Eve Horizon CLI",
   "license": "MIT",
   "repository": {