@eve-horizon/cli 0.2.11 → 0.2.13

package/dist/lib/help.js

@@ -1,1572 +0,0 @@
-"use strict";
-/**
- * Progressive help system for Eve Horizon CLI.
- *
- * Help is available at every level:
- * - eve --help              → top-level commands
- * - eve profile --help      → profile subcommands
- * - eve profile set --help  → specific usage
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HELP = void 0;
-exports.showMainHelp = showMainHelp;
-exports.showCommandHelp = showCommandHelp;
-exports.showSubcommandHelp = showSubcommandHelp;
-exports.shouldShowHelp = shouldShowHelp;
-exports.HELP = {
-    org: {
-        description: 'Manage organizations. Organizations group projects and users.',
-        usage: 'eve org <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List all organizations',
-                usage: 'eve org list [--limit N] [--offset N]',
-                options: [
-                    '--limit <n>          Number of results (default: 10)',
-                    '--offset <n>         Skip first n results',
-                    '--include-deleted    Include soft-deleted orgs',
-                ],
-            },
-            get: {
-                description: 'Get organization details',
-                usage: 'eve org get <org_id>',
-            },
-            ensure: {
-                description: 'Create org if it doesn\'t exist, or return existing',
-                usage: 'eve org ensure <name>',
-                examples: ['eve org ensure "My Company"'],
-            },
-            update: {
-                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: {
-        description: 'Manage projects. Projects link a git repo to an organization for running jobs.',
-        usage: 'eve project <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List projects in an organization',
-                usage: 'eve project list [--org <org_id>]',
-                options: [
-                    '--org <id>           Organization ID (uses profile default)',
-                    '--limit <n>          Number of results',
-                    '--offset <n>         Skip first n results',
-                ],
-            },
-            get: {
-                description: 'Get project details',
-                usage: 'eve project get <project_id>',
-            },
-            ensure: {
-                description: 'Create project if it doesn\'t exist, or return existing',
-                usage: 'eve project ensure --name <name> --repo-url <url> [--org <org_id>] [--branch <branch>] [--slug <slug>]',
-                options: [
-                    '--name <name>        Project name (required)',
-                    '--repo-url <url>     Git repository URL (required)',
-                    '--org <id>           Organization ID',
-                    '--branch <branch>    Default branch (default: main)',
-                    '--slug <slug>        Short memorable slug (4-8 chars, e.g., MyProj)',
-                    '--force              Re-clone repo even if project exists',
-                ],
-                examples: [
-                    'eve project ensure --name my-app --slug MyApp --repo-url https://github.com/org/repo',
-                    'eve project ensure --name my-app --repo-url file:///path/to/repo --force  # dev/test only',
-                ],
-            },
-            update: {
-                description: 'Update project',
-                usage: 'eve project update <project_id> [--name <name>] [--deleted <bool>]',
-            },
-            sync: {
-                description: 'Sync manifest from local .eve/manifest.yaml to Eve API',
-                usage: 'eve project sync [project] [--path <manifest_path>]',
-                options: [
-                    '<project>             Project ID (uses profile default if omitted)',
-                    '--path <path>         Path to manifest (default: .eve/manifest.yaml)',
-                    '--validate-secrets    Validate manifest required secrets',
-                    '--strict              Fail sync if required secrets are missing',
-                ],
-                examples: [
-                    'eve project sync',
-                    'eve project sync proj_xxx',
-                    'eve project sync --path ./custom-manifest.yaml',
-                ],
-            },
-        },
-    },
-    manifest: {
-        description: 'Validate project manifests for schema and required secrets.',
-        usage: 'eve manifest <subcommand> [options]',
-        subcommands: {
-            validate: {
-                description: 'Validate a manifest (schema + secrets)',
-                usage: 'eve manifest validate [--project <id>] [--path <path>] [--latest]',
-                options: [
-                    '--project <id>       Project ID (uses profile default)',
-                    '--path <path>        Path to manifest (default: .eve/manifest.yaml)',
-                    '--latest             Validate latest synced manifest instead of local file',
-                    '--validate-secrets   Validate required secrets (from manifest)',
-                    '--strict             Fail validation if required secrets are missing',
-                ],
-                examples: [
-                    'eve manifest validate',
-                    'eve manifest validate --project proj_xxx',
-                    'eve manifest validate --latest --project proj_xxx',
-                ],
-            },
-        },
-    },
-    secrets: {
-        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> [--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',
-                    '--type <type>        env_var | file | github_token | ssh_key',
-                ],
-            },
-            list: {
-                description: 'List secrets (metadata only)',
-                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> [--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> [--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>] [--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: {
-                description: 'Validate manifest-required secrets for a project',
-                usage: 'eve secrets validate --project <id> [--keys <k1,k2>]',
-                options: [
-                    '--project <id>       Project ID (uses profile default)',
-                    '--keys <k1,k2>       Explicit keys to validate (default: latest manifest)',
-                ],
-            },
-            ensure: {
-                description: 'Ensure safe secrets exist at project scope',
-                usage: 'eve secrets ensure --project <id> --keys <k1,k2>',
-                options: [
-                    '--project <id>       Project ID (uses profile default)',
-                    '--keys <k1,k2>       Keys to ensure (allowlist only)',
-                ],
-            },
-            export: {
-                description: 'Export safe secrets for external configuration',
-                usage: 'eve secrets export --project <id> --keys <k1,k2> [--json]',
-                options: [
-                    '--project <id>       Project ID (uses profile default)',
-                    '--keys <k1,k2>       Keys to export (allowlist only)',
-                    '--json               JSON output',
-                ],
-            },
-        },
-        examples: [
-            'eve secrets set GITHUB_TOKEN ghp_xxx --project proj_xxx --type github_token',
-            'eve secrets show GITHUB_TOKEN --project proj_xxx',
-            'eve secrets validate --project proj_xxx',
-            'eve secrets ensure --project proj_xxx --keys GITHUB_WEBHOOK_SECRET',
-            'eve secrets export --project proj_xxx --keys GITHUB_WEBHOOK_SECRET',
-        ],
-    },
-    job: {
-        description: `Manage jobs. Jobs are units of work executed by AI agents against a project's repo.
-
-Phase lifecycle: idea → backlog → ready → active → review → done (or cancelled)
-Jobs default to 'ready' phase, making them immediately schedulable.`,
-        usage: 'eve job <subcommand> [options]',
-        subcommands: {
-            create: {
-                description: 'Create a new job',
-                usage: 'eve job create --project <id> --description "..." [options]',
-                options: [
-                    '--project <id>         Project ID (or use profile default)',
-                    '--description <text>   Work description/prompt (required)',
-                    '--title <text>         Title (auto-generated from description if omitted)',
-                    '--parent <id>          Parent job ID (for sub-jobs)',
-                    '--type <type>          Issue type: task, bug, feature, epic, chore (default: task)',
-                    '--priority <0-4>       Priority P0-P4 (default: 2)',
-                    '--phase <phase>        Initial phase (default: ready)',
-                    '--review <type>        Review requirement: none, human, agent (default: none)',
-                    '--labels <a,b,c>       Comma-separated labels',
-                    '--assignee <id>        Assign to agent/user',
-                    '--defer-until <date>   Hide until date (ISO 8601)',
-                    '--due-at <date>        Deadline (ISO 8601)',
-                    '',
-                    'Harness selection (top-level job fields):',
-                    '--harness <name>       Preferred harness, e.g., mclaude',
-                    '--profile <name>       Harness profile name',
-                    '--variant <name>       Harness variant preset',
-                    '--model <name>         Model override for harness',
-                    '--reasoning <level>    Reasoning effort: low|medium|high|x-high',
-                    '',
-                    'Scheduling hints (used by scheduler when claiming):',
-                    '--worker-type <type>   Worker type preference',
-                    '--permission <policy>  Permission policy: default, auto_edit, yolo',
-                    '--timeout <seconds>    Execution timeout',
-                    '',
-                    'Inline execution (for agents creating sub-jobs):',
-                    '--claim                Create and immediately claim the job',
-                    '--agent <id>           Agent ID for claim (default: $EVE_AGENT_ID)',
-                    '',
-                    'Git controls (optional, override project/manifest defaults):',
-                    '--git-ref <ref>              Target ref (branch, tag, or SHA)',
-                    '--git-ref-policy <policy>    auto|env|project_default|explicit',
-                    '--git-branch <branch>        Branch to create/checkout',
-                    '--git-create-branch <mode>   never|if_missing|always',
-                    '--git-commit <policy>        never|manual|auto|required',
-                    '--git-commit-message <text>  Commit message template',
-                    '--git-push <policy>          never|on_success|required',
-                    '--git-remote <remote>        Remote to push to (default: origin)',
-                    '',
-                    'Workspace options:',
-                    '--workspace-mode <mode>      job|session|isolated (default: job)',
-                    '--workspace-key <key>        Workspace key for session mode',
-                ],
-                examples: [
-                    'eve job create --description "Fix the login bug in auth.ts"',
-                    'eve job create --description "Add dark mode" --priority 1 --harness mclaude',
-                    'eve job create --parent MyProj-abc123 --description "Implement tokens" --claim',
-                    'eve job create --description "Feature branch work" --git-branch feature/new-api --git-push on_success',
-                ],
-            },
-            list: {
-                description: 'List jobs in a project',
-                usage: 'eve job list [--project <id>] [--phase <phase>] [--assignee <id>] [--since <time>] [--stuck]',
-                options: [
-                    '--project <id>       Project ID (or use profile default)',
-                    '--phase <phase>      Filter by phase',
-                    '--assignee <id>      Filter by assignee',
-                    '--priority <n>       Filter by priority',
-                    '--since <time>       Filter jobs created after time (e.g., "1h", "30m", "2d", or ISO timestamp)',
-                    '--stuck              Show only jobs stuck in active phase (no progress for 5+ min)',
-                    '--stuck-minutes <n>  Minutes threshold for stuck detection (default: 5)',
-                    '--limit <n>          Number of results (default: 50)',
-                    '--offset <n>         Skip first n results',
-                ],
-                examples: [
-                    'eve job list --phase active',
-                    'eve job list --since 1h',
-                    'eve job list --stuck',
-                ],
-            },
-            ready: {
-                description: 'Show schedulable jobs (ready phase, not blocked, not deferred)',
-                usage: 'eve job ready [--project <id>] [--limit <n>]',
-                options: [
-                    '--project <id>       Project ID (or use profile default)',
-                    '--limit <n>          Number of results (default: 10)',
-                ],
-            },
-            blocked: {
-                description: 'Show jobs blocked by dependencies',
-                usage: 'eve job blocked [--project <id>]',
-                options: [
-                    '--project <id>       Project ID (or use profile default)',
-                ],
-            },
-            show: {
-                description: 'Get job details',
-                usage: 'eve job show <job-id> [--verbose]',
-                options: [
-                    '--verbose            Include attempt details, exit codes, durations',
-                ],
-                examples: ['eve job show MyProj-abc123', 'eve job show MyProj-abc123 --verbose'],
-            },
-            current: {
-                description: 'Get the current job context (defaults to EVE_JOB_ID)',
-                usage: 'eve job current [<job-id>] [--json|--tree]',
-                options: [
-                    '--tree               Render job hierarchy instead of JSON',
-                ],
-                examples: ['eve job current', 'eve job current MyProj-abc123 --tree'],
-            },
-            diagnose: {
-                description: 'Comprehensive job debugging (state, attempts, timeline, logs, recommendations)',
-                usage: 'eve job diagnose <job-id>',
-                examples: ['eve job diagnose MyProj-abc123'],
-            },
-            tree: {
-                description: 'Show job hierarchy (parent + children)',
-                usage: 'eve job tree <job-id>',
-                examples: ['eve job tree MyProj-abc123'],
-            },
-            update: {
-                description: 'Update job fields',
-                usage: 'eve job update <job-id> [--phase <phase>] [--priority <n>] ...',
-                options: [
-                    '--phase <phase>       Transition phase (validated)',
-                    '--priority <n>        Set priority (0-4)',
-                    '--assignee <id>       Set assignee',
-                    '--title <text>        Update title',
-                    '--description <text>  Update description',
-                    '--labels <a,b,c>      Set labels',
-                    '--defer-until <date>  Set defer date',
-                    '--due-at <date>       Set due date',
-                    '--review <type>       Set review requirement',
-                    '',
-                    'Git controls (optional, override project/manifest defaults):',
-                    '--git-ref <ref>              Target ref (branch, tag, or SHA)',
-                    '--git-ref-policy <policy>    auto|env|project_default|explicit',
-                    '--git-branch <branch>        Branch to create/checkout',
-                    '--git-create-branch <mode>   never|if_missing|always',
-                    '--git-commit <policy>        never|manual|auto|required',
-                    '--git-commit-message <text>  Commit message template',
-                    '--git-push <policy>          never|on_success|required',
-                    '--git-remote <remote>        Remote to push to (default: origin)',
-                    '',
-                    'Workspace options:',
-                    '--workspace-mode <mode>      job|session|isolated (default: job)',
-                    '--workspace-key <key>        Workspace key for session mode',
-                ],
-                examples: [
-                    'eve job update MyProj-abc123 --git-branch feature/work --git-push on_success',
-                    'eve job update MyProj-abc123 --workspace-mode session --workspace-key session:123',
-                ],
-            },
-            close: {
-                description: 'Mark job as done',
-                usage: 'eve job close <job-id> [--reason "..."]',
-                options: [
-                    '--reason <text>      Completion reason',
-                ],
-            },
-            cancel: {
-                description: 'Mark job as cancelled',
-                usage: 'eve job cancel <job-id> [--reason "..."]',
-                options: [
-                    '--reason <text>      Cancellation reason',
-                ],
-            },
-            dep: {
-                description: 'Manage job dependencies',
-                usage: 'eve job dep <add|remove|list> [args]',
-                options: [
-                    'add <from> <to>      Add dependency: from depends on to',
-                    'remove <from> <to>   Remove dependency',
-                    'list <job-id>        Show dependencies and dependents',
-                ],
-                examples: [
-                    'eve job dep add MyProj-abc123 MyProj-def456',
-                    'eve job dep list MyProj-abc123',
-                ],
-            },
-            claim: {
-                description: 'Claim a job for execution (creates attempt, transitions to active)',
-                usage: 'eve job claim <job-id> [--agent <id>] [--harness <name>]',
-                options: [
-                    '--agent <id>         Agent identifier (default: $EVE_AGENT_ID or cli-user)',
-                    '--harness <name>     Harness to use (overrides job harness)',
-                    '',
-                    'NOTE: This is typically called by the scheduler or by agents creating',
-                    'sub-jobs. For normal workflows, jobs are auto-scheduled when ready.',
-                ],
-            },
-            release: {
-                description: 'Release a claimed job (ends attempt, returns to ready)',
-                usage: 'eve job release <job-id> [--agent <id>] [--reason "..."]',
-                options: [
-                    '--agent <id>         Agent identifier (default: $EVE_AGENT_ID or cli-user)',
-                    '--reason <text>      Release reason',
-                ],
-            },
-            attempts: {
-                description: 'List execution attempts for a job',
-                usage: 'eve job attempts <job-id>',
-            },
-            logs: {
-                description: 'View execution logs for a job attempt',
-                usage: 'eve job logs <job-id> [--attempt <n>] [--after <seq>]',
-                options: [
-                    '--attempt <n>        Attempt number (default: latest)',
-                    '--after <seq>        Return logs after sequence number',
-                ],
-            },
-            submit: {
-                description: 'Submit job for review',
-                usage: 'eve job submit <job-id> --summary "..."',
-                options: [
-                    '--summary <text>     Submission summary (required)',
-                    '--agent-id <id>      Agent ID (default: cli-user)',
-                ],
-            },
-            approve: {
-                description: 'Approve a job in review',
-                usage: 'eve job approve <job-id> [--comment "..."]',
-                options: [
-                    '--comment <text>     Approval comment',
-                    '--reviewer-id <id>   Reviewer ID (default: cli-user)',
-                ],
-            },
-            reject: {
-                description: 'Reject a job in review (creates new attempt)',
-                usage: 'eve job reject <job-id> --reason "..."',
-                options: [
-                    '--reason <text>      Rejection reason (required)',
-                    '--reviewer-id <id>   Reviewer ID (default: cli-user)',
-                ],
-            },
-            result: {
-                description: 'Get job execution result',
-                usage: 'eve job result <job-id> [--attempt <n>]',
-                options: [
-                    '--attempt <n>        Attempt number (default: latest)',
-                ],
-                examples: ['eve job result MyProj-abc123'],
-            },
-            wait: {
-                description: 'Wait for job completion, polling until done',
-                usage: 'eve job wait <job-id> [--timeout <seconds>] [--quiet]',
-                options: [
-                    '--timeout <seconds>  Max wait time (default: 300)',
-                    '--quiet              Suppress progress output',
-                ],
-                examples: ['eve job wait MyProj-abc123', 'eve job wait MyProj-abc123 --timeout 600'],
-            },
-            follow: {
-                description: 'Stream job logs in real-time (SSE)',
-                usage: 'eve job follow <job-id> [--raw] [--no-result]',
-                options: [
-                    '--raw                Show raw log entries',
-                    '--no-result          Don\'t fetch final result when done',
-                ],
-                examples: ['eve job follow MyProj-abc123'],
-            },
-        },
-        examples: [
-            'eve job create --description "Fix the bug in auth.ts"',
-            'eve job list --phase ready',
-            'eve job show MyProj-abc123',
-            'eve job close MyProj-abc123 --reason "Completed"',
-        ],
-    },
-    harness: {
-        description: 'Inspect available harnesses, variants, and auth status.',
-        usage: 'eve harness <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List available harnesses',
-                usage: 'eve harness list [--capabilities]',
-                options: [
-                    '--capabilities      Show model/reasoning capability hints',
-                ],
-            },
-            get: {
-                description: 'Get harness details and auth requirements',
-                usage: 'eve harness get <name>',
-                examples: ['eve harness get mclaude'],
-            },
-        },
-        examples: ['eve harness list', 'eve harness get mclaude'],
-    },
-    agents: {
-        description: 'Inspect agent policy config and harness capabilities for orchestration. Default profile: primary-orchestrator.',
-        usage: 'eve agents <config|sync> [options]',
-        subcommands: {
-            config: {
-                description: 'Show agent policy (profiles/councils) and harness availability',
-                usage: 'eve agents config [--path <dir>] [--no-harnesses]',
-                options: [
-                    '--path <dir>        Repository root to inspect (default: cwd)',
-                    '--repo-dir <dir>    Alias for --path',
-                    '--no-harnesses      Skip harness availability lookup',
-                ],
-                examples: [
-                    'eve agents config',
-                    'eve agents config --json',
-                    'eve agents config --path ../my-repo',
-                ],
-            },
-            sync: {
-                description: 'Sync agents.yaml/teams.yaml/chat.yaml to the API',
-                usage: 'eve agents sync --project <id> --ref <sha|branch> [--repo-dir <path>]',
-                options: [
-                    '--project <id>      Project ID (uses profile default)',
-                    '--ref <ref>         Git ref to sync (required unless --local)',
-                    '--local             Allow local sync (only for localhost/lvh.me API)',
-                    '--allow-dirty       Allow syncing a dirty working tree',
-                    '--repo-dir <path>   Repository root (default: cwd)',
-                    '--force-nonlocal    Allow --local against non-local API URL',
-                ],
-                examples: [
-                    'eve agents sync --project proj_xxx --ref main',
-                    'eve agents sync --project proj_xxx --ref HEAD',
-                    'eve agents sync --project proj_xxx --local --allow-dirty',
-                ],
-            },
-        },
-        examples: ['eve agents config --json', 'eve agents sync --project proj_xxx --ref main'],
-    },
-    profile: {
-        description: `Manage repo-local CLI profiles. Profiles store defaults (API URL, org, project) so you don't
-have to specify them on every command.
-
-Profiles live in .eve/profile.yaml inside the repo, so each project keeps its own defaults
-and switching profiles won't affect other checkouts.`,
-        usage: 'eve profile <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List all profiles',
-                usage: 'eve profile list',
-            },
-            show: {
-                description: 'Show profile details',
-                usage: 'eve profile show [name]',
-                examples: ['eve profile show', 'eve profile show prod'],
-            },
-            use: {
-                description: 'Switch active profile (repo-local)',
-                usage: 'eve profile use <name> [--org <id>] [--project <id>]',
-                options: [
-                    '--org <id>             Set org override',
-                    '--project <id>         Set project override',
-                    '--api-url <url>        Set API URL override',
-                    '--clear                Remove local .eve/profile.yaml (clears all profiles)',
-                ],
-                examples: [
-                    'eve profile use staging --org org_xxx --project proj_yyy',
-                    'eve profile use --clear',
-                ],
-            },
-            create: {
-                description: 'Create a new named profile (repo-local)',
-                usage: 'eve profile create <name> [--api-url <url>] [--org <id>] [--project <id>]',
-                options: [
-                    '--api-url <url>           API base URL',
-                    '--org <id>                Default organization ID',
-                    '--project <id>            Default project ID',
-                    '--harness <name>          Default harness (e.g., mclaude:fast)',
-                    '--supabase-url <url>      Supabase URL (for cloud auth)',
-                    '--supabase-anon-key <key> Supabase anon key',
-                    '--default-email <email>   Default email for auth login',
-                    '--default-ssh-key <path>  Default SSH key path for auth login',
-                ],
-                examples: [
-                    'eve profile create local --api-url http://localhost:4701',
-                    'eve profile create prod --api-url https://api.example.com --org org_xxx',
-                ],
-            },
-            set: {
-                description: 'Update profile settings (repo-local)',
-                usage: 'eve profile set [name] [--org <id>] [--project <id>]',
-                options: [
-                    '--org <id>                Default organization ID',
-                    '--project <id>            Default project ID',
-                    '--api-url <url>           API base URL',
-                    '--harness <name>          Default harness',
-                    '--supabase-url <url>      Supabase URL',
-                    '--supabase-anon-key <key> Supabase anon key',
-                    '--default-email <email>   Default email for auth login',
-                    '--default-ssh-key <path>  Default SSH key path for auth login',
-                ],
-                examples: [
-                    'eve profile set --org org_xxx --project proj_yyy',
-                    'eve profile set staging --org org_xxx --project proj_yyy',
-                    'eve profile set --default-email user@example.com',
-                ],
-            },
-            remove: {
-                description: 'Remove a named profile (repo-local)',
-                usage: 'eve profile remove <name>',
-            },
-        },
-        examples: [
-            'eve profile set --org org_xxx --project proj_yyy     # writes .eve/profile.yaml',
-            'eve profile use staging --org org_xxx                 # writes .eve/profile.yaml',
-            'eve profile set --default-email me@dev.com            # writes .eve/profile.yaml',
-        ],
-    },
-    auth: {
-        description: `Authenticate with Eve Horizon. Auth is optional for local development but required
-for cloud deployments. Credentials are stored globally per API URL.`,
-        usage: 'eve auth <login|logout|status|whoami|bootstrap|sync|creds|token|mint>',
-        subcommands: {
-            login: {
-                description: 'Login via GitHub SSH challenge (default) or Supabase (legacy)',
-                usage: 'eve auth login [--email <email>] [--ssh-key <path>] [--ttl <days>]',
-                options: [
-                    '--email <email>         Email address for SSH login (uses profile default_email if not provided)',
-                    '--user-id <id>          User id for SSH login',
-                    '--ssh-key <path>        Path to SSH private key (uses profile default_ssh_key, then ~/.ssh/id_ed25519)',
-                    '--ttl <days>            Token TTL in days (1-90, default: server configured)',
-                    '--password <pass>       Supabase password (triggers Supabase login)',
-                    '--supabase-url <url>    Supabase URL',
-                    '--supabase-anon-key <key> Supabase anon key',
-                ],
-                examples: [
-                    'eve auth login --email user@example.com',
-                    'eve auth login --email user@example.com --ttl 30',
-                    'eve auth login  # uses profile defaults if set',
-                    'eve auth login --ssh-key ~/.ssh/id_rsa',
-                ],
-            },
-            logout: {
-                description: 'Clear stored credentials',
-                usage: 'eve auth logout',
-            },
-            status: {
-                description: 'Check authentication status',
-                usage: 'eve auth status',
-            },
-            whoami: {
-                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',
-                ],
-            },
-            mint: {
-                description: 'Mint a user token (admin-only, no SSH login required)',
-                usage: 'eve auth mint --email <email> [--org <org_id> | --project <project_id>] [--role <role>] [--ttl <days>]',
-                options: [
-                    '--email <email>     Target user email (created if missing)',
-                    '--org <org_id>      Org scope for membership and permission checks',
-                    '--project <id>      Project scope for membership and permission checks',
-                    '--role <role>       Role to assign (member|admin), default member',
-                    '--ttl <days>        Token TTL in days (1-90, default: server configured)',
-                ],
-                examples: [
-                    'eve auth mint --email app-bot@example.com --org org_xxx',
-                    'eve auth mint --email app-bot@example.com --project proj_xxx',
-                    'eve auth mint --email app-bot@example.com --project proj_xxx --role admin',
-                    'eve auth mint --email bot@example.com --org org_xxx --ttl 90',
-                ],
-            },
-            bootstrap: {
-                description: 'Bootstrap the first admin user with flexible security modes',
-                usage: 'eve auth bootstrap --email <email> [--token <token>] [options]',
-                options: [
-                    '--email <email>      Admin email address (required for bootstrap)',
-                    '--token <token>      Bootstrap token (required in secure mode, or use EVE_BOOTSTRAP_TOKEN)',
-                    '--ssh-key <path>     Path to SSH public key (default: ~/.ssh/id_ed25519.pub)',
-                    '--display-name <name> Display name for the admin user',
-                    '--status             Check bootstrap status instead of bootstrapping',
-                    '',
-                    'Bootstrap modes (configured server-side via BOOTSTRAP_MODE):',
-                    '  auto-open          Token not required during initial window (default for new installs)',
-                    '  recovery           Like auto-open, but for disaster recovery scenarios',
-                    '  secure             Token always required (recommended for production)',
-                    '  closed             Bootstrap disabled (use database seeding instead)',
-                ],
-                examples: [
-                    'eve auth bootstrap --status',
-                    'eve auth bootstrap --email admin@example.com',
-                    'eve auth bootstrap --email admin@example.com --token secret123',
-                    'EVE_BOOTSTRAP_TOKEN=secret123 eve auth bootstrap --email admin@example.com',
-                    'eve auth bootstrap --email admin@example.com --ssh-key ~/.ssh/id_rsa.pub',
-                ],
-            },
-            sync: {
-                description: 'Extract OAuth tokens from host and set as Eve secrets',
-                usage: 'eve auth sync [--claude] [--codex] [--org <id>] [--project <id>] [--dry-run]',
-                options: [
-                    '--claude           Only extract Claude/Anthropic tokens',
-                    '--codex            Only extract Codex/OpenAI tokens',
-                    '--org <id>         Set as org-level secrets',
-                    '--project <id>     Set as project-level secrets',
-                    '--dry-run          Show what would be set without actually setting',
-                    '',
-                    'Scope priority: --project > --org > user (default)',
-                    'Default scope is user-level, so credentials are available to all your jobs.',
-                ],
-                examples: [
-                    'eve auth sync                    # Sync to user-level (default)',
-                    'eve auth sync --org org_xxx      # Sync to org-level',
-                    'eve auth sync --project proj_xxx # Sync to project-level',
-                    'eve auth sync --dry-run          # Preview without syncing',
-                ],
-            },
-            creds: {
-                description: 'Show local AI tool credentials (Claude Code, Codex/Code) without syncing',
-                usage: 'eve auth creds [--claude] [--codex]',
-                options: [
-                    '--claude           Only check Claude/Anthropic credentials',
-                    '--codex            Only check Codex/OpenAI credentials',
-                ],
-                examples: [
-                    'eve auth creds',
-                    'eve auth creds --claude',
-                    'eve auth creds --json',
-                ],
-            },
-        },
-    },
-    env: {
-        description: 'Manage environments for projects. Environments are deployment targets (staging, production, test).',
-        usage: 'eve env <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List environments for a project',
-                usage: 'eve env list [project]',
-                options: [
-                    '<project>             Project ID or slug (uses profile default if omitted)',
-                ],
-                examples: ['eve env list', 'eve env list proj_xxx'],
-            },
-            show: {
-                description: 'Show details of an environment',
-                usage: 'eve env show <project> <name>',
-                examples: ['eve env show proj_xxx staging', 'eve env show my-project production'],
-            },
-            create: {
-                description: 'Create an environment',
-                usage: 'eve env create <name> --type=<type> [options]',
-                options: [
-                    '<name>                Environment name (e.g., staging, production, test)',
-                    '--type <type>         Environment type: persistent or temporary (required)',
-                    '--namespace <ns>      K8s namespace (optional)',
-                    '--db-ref <ref>        Database reference (optional)',
-                    '--project <id>        Project ID (uses profile default if omitted)',
-                ],
-                examples: [
-                    'eve env create staging --type=persistent',
-                    'eve env create test --type=persistent --namespace=eve-test',
-                ],
-            },
-            deploy: {
-                description: 'Deploy to an environment',
-                usage: 'eve env deploy <env> --ref <sha> [--direct] [--inputs <json>] [--image-tag <tag>] [--repo-dir <path>] [--project <id>]',
-                options: [
-                    '<env>                  Environment name (staging, production, test)',
-                    '--ref <sha>            Git SHA (required). Non-SHA refs resolve against the repo in --repo-dir or cwd.',
-                    '--direct               Bypass pipeline and do direct deploy',
-                    '--inputs <json>        JSON inputs for the deployment (e.g., \'{"release_id":"rel_xxx"}\')',
-                    '--image-tag <tag>      Use a specific image tag for deploy (direct only)',
-                    '--repo-dir <path>      Resolve --ref against this repo instead of cwd',
-                    '--project <id>         Project ID or slug (uses profile default if omitted)',
-                    '--watch                Poll deployment status until ready (default: true)',
-                    '--timeout <seconds>    Watch timeout in seconds (default: 120)',
-                ],
-                examples: [
-                    'eve env deploy staging --ref 0123456789abcdef0123456789abcdef01234567',
-                    'eve env deploy staging --ref 0123456789abcdef0123456789abcdef01234567 --direct',
-                    'eve env deploy staging --ref 0123456789abcdef0123456789abcdef01234567 --inputs \'{"release_id":"rel_xxx","smoke_test":false}\'',
-                    'eve env deploy staging --ref 0123456789abcdef0123456789abcdef01234567 --direct --inputs \'{"release_id":"rel_xxx"}\'',
-                    'eve env deploy staging --ref main --repo-dir ./my-app',
-                ],
-            },
-            diagnose: {
-                description: 'Diagnose environment deployments (k8s-only)',
-                usage: 'eve env diagnose <project> <env> [--events <n>]',
-                options: [
-                    '<project>             Project ID or slug',
-                    '<env>                 Environment name',
-                    '--events <n>          Limit number of recent events',
-                ],
-                examples: [
-                    'eve env diagnose proj_xxx staging',
-                    'eve env diagnose proj_xxx staging --events 20',
-                ],
-            },
-            logs: {
-                description: 'Fetch logs for a service in an environment (k8s-only)',
-                usage: 'eve env logs <project> <env> <service> [--since <seconds>] [--tail <n>] [--grep <text>]',
-                options: [
-                    '<project>             Project ID or slug',
-                    '<env>                 Environment name (staging, production, test)',
-                    '<service>             Service name from manifest',
-                    '--since <seconds>     Seconds since now (optional)',
-                    '--tail <n>            Tail line count (optional)',
-                    '--grep <text>         Filter lines containing text (optional)',
-                ],
-                examples: [
-                    'eve env logs proj_xxx staging api --tail 200',
-                    '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 staging --ref abc123',
-            'eve env logs proj_xxx staging api --tail 200',
-            'eve env diagnose proj_xxx staging',
-        ],
-    },
-    api: {
-        description: 'Explore project API sources and call them with Eve auth.',
-        usage: 'eve api <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List API sources for a project',
-                usage: 'eve api list [project] [--env <name>]',
-                options: [
-                    '<project>             Project ID (uses profile default if omitted)',
-                    '--env <name>          Environment name (optional filter)',
-                ],
-                examples: ['eve api list', 'eve api list proj_xxx --env staging'],
-            },
-            show: {
-                description: 'Show details for a single API source',
-                usage: 'eve api show <name> [project]',
-                options: ['--env <name>          Environment name (optional filter)'],
-                examples: ['eve api show app', 'eve api show app proj_xxx --env staging'],
-            },
-            spec: {
-                description: 'Show cached API spec (OpenAPI/GraphQL)',
-                usage: 'eve api spec <name> [project]',
-                options: ['--env <name>          Environment name (optional filter)'],
-                examples: ['eve api spec app', 'eve api spec app proj_xxx --env staging'],
-            },
-            refresh: {
-                description: 'Refresh cached API spec',
-                usage: 'eve api refresh <name> [project]',
-                options: ['--env <name>          Environment name (optional filter)'],
-                examples: ['eve api refresh app --env staging'],
-            },
-            examples: {
-                description: 'Print curl templates from the cached API spec',
-                usage: 'eve api examples <name> [project]',
-                options: ['--env <name>          Environment name (optional filter)'],
-                examples: ['eve api examples app', 'eve api examples app --env staging'],
-            },
-            call: {
-                description: 'Call an API endpoint with Eve auth',
-                usage: 'eve api call <name> <method> <path> [options]',
-                options: [
-                    '--project <id>       Project ID (uses profile default)',
-                    '--env <name>         Environment name (optional source)',
-                    '--json <payload>     JSON body inline or @file',
-                    '--jq <expr>          Filter JSON output with jq',
-                    '--graphql <query>    GraphQL query inline or @file',
-                    '--variables <json>   JSON variables for GraphQL query',
-                    '--token <token>      Override auth token',
-                    '--print-curl         Print curl command instead of executing',
-                ],
-                examples: [
-                    'eve api call app GET /notes --jq ".items"',
-                    'eve api call app POST /notes --json "{\"title\":\"Hello\"}"',
-                    'eve api call graphql POST /graphql --graphql "{ notes { id } }"',
-                ],
-            },
-        },
-    },
-    db: {
-        description: 'Inspect and query environment databases with Eve auth + RLS.',
-        usage: 'eve db <subcommand> [options]',
-        subcommands: {
-            schema: {
-                description: 'Show database schema for an environment',
-                usage: 'eve db schema --env <name> [--project <id>]',
-                options: ['--env <name>          Environment name (required)'],
-                examples: ['eve db schema --env staging'],
-            },
-            rls: {
-                description: 'Show RLS policies and tables for an environment',
-                usage: 'eve db rls --env <name> [--project <id>]',
-                options: ['--env <name>          Environment name (required)'],
-                examples: ['eve db rls --env staging'],
-            },
-            sql: {
-                description: 'Run parameterized SQL as the calling user',
-                usage: 'eve db sql --env <name> --sql <statement> [options]',
-                options: [
-                    '--env <name>          Environment name (required)',
-                    '--sql <statement>     SQL to run (inline)',
-                    '--file <path>         Read SQL from file',
-                    '--params <json>       JSON array/object of parameters',
-                    '--write               Allow writes (requires db.write scope)',
-                ],
-                examples: [
-                    'eve db sql --env staging --sql "select * from notes"',
-                    'eve db sql --env staging --file ./query.sql --params "[1]"',
-                ],
-            },
-        },
-    },
-    pipeline: {
-        description: 'Run and inspect pipelines defined in the project manifest.',
-        usage: 'eve pipeline <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List pipelines for a project',
-                usage: 'eve pipeline list [project]',
-                options: [
-                    '<project>             Project ID or slug (uses profile default if omitted)',
-                ],
-                examples: ['eve pipeline list', 'eve pipeline list proj_xxx'],
-            },
-            show: {
-                description: 'Show pipeline definition',
-                usage: 'eve pipeline show <project> <name>',
-                examples: ['eve pipeline show proj_xxx release', 'eve pipeline show my-project deploy'],
-            },
-            run: {
-                description: 'Run a pipeline',
-                usage: 'eve pipeline run <name> --ref <sha> [--env <env>] [--repo-dir <path>] [--wait] [--only <step>]',
-                options: [
-                    '--ref <sha>          Git SHA (required). Non-SHA refs resolve against the repo in --repo-dir or cwd.',
-                    '--env <env>          Target environment',
-                    '--project <id>       Project ID (uses profile default)',
-                    '--wait               Wait for completion',
-                    '--timeout <n>        Max wait time (seconds)',
-                    '--inputs <json>      JSON inputs for the pipeline',
-                    '--only <step>        Run a single step (includes dependencies)',
-                    '--repo-dir <path>    Resolve --ref against this repo instead of cwd',
-                ],
-                examples: [
-                    'eve pipeline run deploy-test --ref 0123456789abcdef0123456789abcdef01234567 --env test',
-                    'eve pipeline run deploy-test --ref 0123456789abcdef0123456789abcdef01234567 --env test --wait --timeout 120',
-                    'eve pipeline run deploy-test --ref main --repo-dir ./my-app --env test',
-                ],
-            },
-            runs: {
-                description: 'List runs for a pipeline',
-                usage: 'eve pipeline runs <name> [project]',
-                options: [
-                    '--limit <n>          Number of results (default: 10)',
-                    '--offset <n>         Skip first n results',
-                ],
-                examples: ['eve pipeline runs deploy-test', 'eve pipeline runs deploy-test proj_xxx'],
-            },
-            'show-run': {
-                description: 'Show a pipeline run',
-                usage: 'eve pipeline show-run <name> <run-id> [--project <id>]',
-                examples: ['eve pipeline show-run deploy-test prun_xxx'],
-            },
-            approve: {
-                description: 'Approve a pipeline run awaiting approval',
-                usage: 'eve pipeline approve <run-id>',
-                examples: ['eve pipeline approve prun_xxx'],
-            },
-            cancel: {
-                description: 'Cancel a pipeline run',
-                usage: 'eve pipeline cancel <run-id> [--reason <text>]',
-                examples: ['eve pipeline cancel prun_xxx --reason "superseded"'],
-            },
-            logs: {
-                description: 'Show logs for a pipeline run',
-                usage: 'eve pipeline logs <pipeline> <run-id> [--step <name>] [--follow]',
-                options: [
-                    '--step <name>        Show logs for a specific step only',
-                    '--follow (-f)        Stream live logs via SSE',
-                    '--project <id>       Project ID (uses profile default)',
-                ],
-                examples: [
-                    'eve pipeline logs deploy-test prun_xxx',
-                    'eve pipeline logs deploy-test prun_xxx --step build',
-                    'eve pipeline logs deploy-test prun_xxx --follow',
-                ],
-            },
-        },
-        examples: ['eve pipeline list', 'eve pipeline run deploy-test --ref 0123456789abcdef0123456789abcdef01234567 --env test', 'eve pipeline logs deploy-test prun_xxx --follow'],
-    },
-    workflow: {
-        description: 'Inspect workflows defined in the project manifest (read-only in Phase 1).',
-        usage: 'eve workflow <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List workflows for a project',
-                usage: 'eve workflow list [project]',
-                options: [
-                    '<project>             Project ID or slug (uses profile default if omitted)',
-                ],
-                examples: ['eve workflow list', 'eve workflow list proj_xxx'],
-            },
-            show: {
-                description: 'Show workflow definition',
-                usage: 'eve workflow show <project> <name>',
-                examples: ['eve workflow show proj_xxx qa-review', 'eve workflow show my-project release-notes'],
-            },
-        },
-        examples: ['eve workflow list', 'eve workflow show proj_xxx qa-review'],
-    },
-    event: {
-        description: 'Emit and inspect events. Apps use this to participate in the Event Ecosystem.',
-        usage: 'eve event <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List events for a project',
-                usage: 'eve event list [project] [--type] [--source] [--status]',
-                options: [
-                    '<project>             Project ID or slug (uses profile default if omitted)',
-                    '--type <type>         Filter by event type (e.g., github.push, app.deploy.complete)',
-                    '--source <source>     Filter by source (e.g., github, cron, app)',
-                    '--status <status>     Filter by status (pending, processed, failed)',
-                    '--limit <n>           Number of results',
-                    '--offset <n>          Skip first n results',
-                ],
-                examples: ['eve event list', 'eve event list --type app.deploy.complete --source app'],
-            },
-            show: {
-                description: 'Show event details',
-                usage: 'eve event show <event_id> [--project <id>]',
-                examples: ['eve event show evt_xxx', 'eve event show evt_xxx --project proj_yyy'],
-            },
-            emit: {
-                description: 'Emit an event to trigger pipelines or notify other services',
-                usage: 'eve event emit --type <type> --source <source> [options]',
-                options: [
-                    '--project <id>        Project ID (required)',
-                    '--type <type>         Event type (e.g., app.build.complete, deploy.finished)',
-                    '--source <source>     Event source (e.g., app, ci, manual)',
-                    '--env <name>          Environment name',
-                    '--branch <branch>     Git branch reference',
-                    '--sha <sha>           Git commit SHA',
-                    '--payload <json>      JSON payload with event data',
-                ],
-                examples: [
-                    'eve event emit --project proj_xxx --type app.build.complete --source app',
-                    'eve event emit --project proj_xxx --type deploy.finished --source ci --env production --payload \'{"version":"1.2.3"}\'',
-                ],
-            },
-        },
-        examples: [
-            'eve event list',
-            'eve event emit --type app.ready --source app --project proj_xxx',
-        ],
-    },
-    skills: {
-        description: 'Install skills from skills.txt using openskills --universal.',
-        usage: 'eve skills <subcommand> [options]',
-        subcommands: {
-            install: {
-                description: 'Install skills from skills.txt manifest',
-                usage: 'eve skills install [--skip-installed] [--no-sync] [--no-commit]',
-                options: [
-                    '--skip-installed  Skip skills that are already installed',
-                    '--no-sync         Skip AGENTS.md sync after install',
-                    '--no-commit       Skip committing AGENTS.md changes',
-                ],
-                examples: [
-                    'eve skills install',
-                    'eve skills install --skip-installed',
-                    'eve skills install --no-commit',
-                ],
-            },
-        },
-        examples: ['eve skills install', 'eve skills install --skip-installed'],
-    },
-    admin: {
-        description: 'Administrative commands for user and identity management.',
-        usage: 'eve admin <subcommand> [options]',
-        subcommands: {
-            invite: {
-                description: 'Invite a user by registering their GitHub SSH keys and adding them to an org',
-                usage: 'eve admin invite --email <email> [--github <username>] [--role <role>] [--org <org_id>]',
-                options: [
-                    '--email <email>       User email address (required)',
-                    '--github <username>   GitHub username to fetch SSH keys from',
-                    '--role <role>         Org role: owner, admin, member (default: member)',
-                    '--org <org_id>        Organization to add user to',
-                ],
-                examples: [
-                    'eve admin invite --email user@example.com --github octocat',
-                    'eve admin invite --email user@example.com --github octocat --role admin --org org_xxx',
-                ],
-            },
-        },
-        examples: [
-            'eve admin invite --email user@example.com --github octocat',
-            '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',
-        ],
-    },
-    build: {
-        description: 'Manage builds. Builds are first-class primitives for container image creation (specs, runs, artifacts).',
-        usage: 'eve build <subcommand> [options]',
-        subcommands: {
-            create: {
-                description: 'Create a new build spec',
-                usage: 'eve build create --project <id> --ref <sha> --manifest-hash <hash> [--services <s1,s2>] [--repo-dir <path>]',
-                options: [
-                    '--project <id>       Project ID (uses profile default)',
-                    '--ref <sha>          Git SHA (required). Non-SHA refs resolve against the repo in --repo-dir or cwd.',
-                    '--manifest-hash <h>  Manifest hash (required)',
-                    '--services <list>    Comma-separated service names to build',
-                    '--repo-dir <path>    Resolve --ref against this repo instead of cwd',
-                ],
-                examples: [
-                    'eve build create --ref 0123456789abcdef0123456789abcdef01234567 --manifest-hash mfst_123',
-                    'eve build create --project proj_xxx --ref 0123456789abcdef0123456789abcdef01234567 --manifest-hash mfst_123 --services api,web',
-                    'eve build create --project proj_xxx --ref main --repo-dir ./my-app --manifest-hash mfst_123',
-                ],
-            },
-            list: {
-                description: 'List build specs for a project',
-                usage: 'eve build list [--project <id>] [--limit <n>] [--offset <n>]',
-                options: [
-                    '--project <id>       Project ID (uses profile default)',
-                    '--limit <n>          Number of results',
-                    '--offset <n>         Skip first n results',
-                ],
-                examples: [
-                    'eve build list',
-                    'eve build list --project proj_xxx --limit 20',
-                ],
-            },
-            show: {
-                description: 'Show build spec details',
-                usage: 'eve build show <build_id>',
-                examples: [
-                    'eve build show build_xxx',
-                ],
-            },
-            run: {
-                description: 'Start a build run for an existing build spec',
-                usage: 'eve build run <build_id>',
-                examples: [
-                    'eve build run build_xxx',
-                ],
-            },
-            runs: {
-                description: 'List runs for a build spec',
-                usage: 'eve build runs <build_id> [--limit <n>]',
-                options: [
-                    '--limit <n>          Number of results',
-                    '--offset <n>         Skip first n results',
-                ],
-                examples: [
-                    'eve build runs build_xxx',
-                ],
-            },
-            logs: {
-                description: 'Show build logs',
-                usage: 'eve build logs <build_id> [--run <run_id>]',
-                options: [
-                    '--run <id>           Specific run ID (default: latest)',
-                ],
-                examples: [
-                    'eve build logs build_xxx',
-                    'eve build logs build_xxx --run brun_yyy',
-                ],
-            },
-            artifacts: {
-                description: 'List build artifacts (images produced)',
-                usage: 'eve build artifacts <build_id>',
-                examples: [
-                    'eve build artifacts build_xxx',
-                ],
-            },
-            diagnose: {
-                description: 'Show full build state (spec, runs, artifacts, logs)',
-                usage: 'eve build diagnose <build_id>',
-                examples: [
-                    'eve build diagnose build_xxx',
-                ],
-            },
-            cancel: {
-                description: 'Cancel an active build run',
-                usage: 'eve build cancel <build_id>',
-                examples: [
-                    'eve build cancel build_xxx',
-                ],
-            },
-        },
-        examples: [
-            'eve build create --ref 0123456789abcdef0123456789abcdef01234567 --manifest-hash mfst_123 --services api,web',
-            'eve build list',
-            'eve build show build_xxx',
-            'eve build run build_xxx',
-            'eve build logs build_xxx',
-            'eve build artifacts build_xxx',
-            'eve build diagnose build_xxx',
-        ],
-    },
-    init: {
-        description: `Initialize a new Eve Horizon project from a template.
-
-Downloads the starter template, strips git history, initializes a fresh repo,
-and installs skills. After init, start your AI coding agent and run the
-eve-new-project-setup skill to complete configuration.`,
-        usage: 'eve init [directory] [--template <url>] [--branch <branch>]',
-        subcommands: {
-            '': {
-                description: 'Initialize project in current or specified directory',
-                usage: 'eve init [directory] [options]',
-                options: [
-                    '[directory]           Target directory (default: current directory)',
-                    '--template <url>      Template repository URL',
-                    '                      (default: https://github.com/incept5/eve-horizon-starter)',
-                    '--branch <branch>     Branch to use (default: main)',
-                    '--skip-skills         Skip automatic skill installation',
-                ],
-                examples: [
-                    'eve init',
-                    'eve init my-project',
-                    'eve init my-project --template https://github.com/myorg/my-template',
-                    'eve init . --branch develop',
-                ],
-            },
-        },
-        examples: [
-            'eve init my-project',
-            'eve init',
-            'eve init my-app --template https://github.com/myorg/custom-starter',
-        ],
-    },
-    system: {
-        description: 'System administration and health checks (admin scope required for most commands).',
-        usage: 'eve system <subcommand> [options]',
-        subcommands: {
-            health: {
-                description: 'Quick health check of the API',
-                usage: 'eve system health',
-                examples: ['eve system health', 'eve system health --json'],
-            },
-            status: {
-                description: 'Show comprehensive system status (admin only)',
-                usage: 'eve system status',
-                examples: ['eve system status', 'eve system status --json'],
-            },
-            jobs: {
-                description: 'List all jobs across all projects (admin view)',
-                usage: 'eve system jobs [--org <id>] [--project <id>] [--phase <phase>] [--limit <n>] [--offset <n>]',
-                options: [
-                    '--org <id>           Filter by organization ID',
-                    '--project <id>       Filter by project ID',
-                    '--phase <phase>      Filter by job phase',
-                    '--limit <n>          Number of results (default: 50)',
-                    '--offset <n>         Skip first n results',
-                ],
-                examples: [
-                    'eve system jobs',
-                    'eve system jobs --phase active',
-                    'eve system jobs --project proj_xxx',
-                ],
-            },
-            envs: {
-                description: 'List all environments across all projects (admin view)',
-                usage: 'eve system envs [--org <id>] [--project <id>] [--limit <n>] [--offset <n>]',
-                options: [
-                    '--org <id>           Filter by organization ID',
-                    '--project <id>       Filter by project ID',
-                    '--limit <n>          Number of results (default: 50)',
-                    '--offset <n>         Skip first n results',
-                ],
-                examples: [
-                    'eve system envs',
-                    'eve system envs --project proj_xxx',
-                ],
-            },
-            logs: {
-                description: 'Fetch recent logs for a system service (admin only)',
-                usage: 'eve system logs <service> [--tail <n>]',
-                options: [
-                    '--tail <n>          Number of log lines (default: 100)',
-                ],
-                examples: [
-                    'eve system logs api',
-                    'eve system logs worker --tail 200',
-                ],
-            },
-            pods: {
-                description: 'List pods across the cluster (admin only)',
-                usage: 'eve system pods',
-                examples: ['eve system pods'],
-            },
-            events: {
-                description: 'List recent cluster events (admin only)',
-                usage: 'eve system events [--limit <n>]',
-                options: [
-                    '--limit <n>         Max number of events (default: 50)',
-                ],
-                examples: ['eve system events', 'eve system events --limit 20'],
-            },
-            config: {
-                description: 'Show deployment configuration summary (system admins only)',
-                usage: 'eve system config',
-                examples: ['eve system config'],
-            },
-            settings: {
-                description: 'Get or set system settings (admin only)',
-                usage: 'eve system settings [get <key>] [set <key> <value>]',
-                options: [
-                    'get <key>            Get specific setting',
-                    'set <key> <value>    Update setting value',
-                ],
-                examples: [
-                    'eve system settings',
-                    'eve system settings get some-key',
-                    'eve system settings set some-key some-value',
-                ],
-            },
-            orchestrator: {
-                description: 'Manage orchestrator concurrency settings',
-                usage: 'eve system orchestrator <status|set-concurrency>',
-                options: [
-                    'status                           Show concurrency status',
-                    'set-concurrency <n>              Set concurrency limit',
-                ],
-                examples: [
-                    'eve system orchestrator status',
-                    'eve system orchestrator set-concurrency 8',
-                ],
-            },
-        },
-        examples: [
-            'eve system health',
-            'eve system status',
-            'eve system jobs',
-            'eve system envs',
-            'eve system logs api',
-            'eve system orchestrator status',
-        ],
-    },
-    integrations: {
-        description: 'Manage chat integrations (Slack) for an organization.',
-        usage: 'eve integrations <subcommand> [options]',
-        subcommands: {
-            list: {
-                description: 'List integrations for an org',
-                usage: 'eve integrations list --org <org_id>',
-                options: ['--org <id>           Organization ID'],
-            },
-            slack: {
-                description: 'Connect a Slack workspace (stub OAuth)',
-                usage: 'eve integrations slack connect --org <org_id> --team-id <team_id> [--token <token>]',
-                options: [
-                    '--org <id>           Organization ID',
-                    '--team-id <id>       Slack team ID',
-                    '--token <token>      Slack access token (stored in tokens_json)',
-                    '--tokens-json <json> Raw tokens_json payload',
-                    '--status <status>    Integration status (default: active)',
-                ],
-            },
-            test: {
-                description: 'Test an integration',
-                usage: 'eve integrations test <integration_id>',
-            },
-        },
-        examples: [
-            'eve integrations list --org org_xxx',
-            'eve integrations slack connect --org org_xxx --team-id T123 --token xoxb-...',
-        ],
-    },
-    chat: {
-        description: 'Chat tooling for gateway testing.',
-        usage: 'eve chat <subcommand> [options]',
-        subcommands: {
-            simulate: {
-                description: 'Simulate an inbound chat message',
-                usage: 'eve chat simulate --project <id> --team-id <team> --text <message>',
-                options: [
-                    '--project <id>      Project ID (uses profile default)',
-                    '--provider <name>   Provider name (default: slack)',
-                    '--team-id <id>      Slack team ID',
-                    '--channel-id <id>   Channel ID',
-                    '--user-id <id>      User ID',
-                    '--thread-key <key>  Thread key override',
-                    '--metadata <json>   Extra metadata JSON',
-                ],
-            },
-        },
-        examples: [
-            'eve chat simulate --project proj_xxx --team-id T123 --text "hello"',
-        ],
-    },
-};
-function showMainHelp() {
-    console.log('Eve Horizon CLI');
-    console.log('');
-    console.log('Usage: eve <command> [subcommand] [options]');
-    console.log('');
-    console.log('Getting Started:');
-    console.log('  init       Initialize a new project from template');
-    console.log('');
-    console.log('Commands:');
-    console.log('  org        Manage organizations');
-    console.log('  project    Manage projects');
-    console.log('  manifest   Validate manifests (schema, secrets)');
-    console.log('  job        Manage jobs (create, list, show, update, claim, etc.)');
-    console.log('  env        Manage environments (list, show, deploy)');
-    console.log('  build      Manage builds (create, run, logs, artifacts)');
-    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)');
-    console.log('  workflow   Inspect manifest workflows (list, show)');
-    console.log('  event      Emit and inspect events (app integration)');
-    console.log('  secrets    Manage secrets (project/org/user scope)');
-    console.log('  harness    Inspect harnesses and auth status');
-    console.log('  agents     Inspect agent policy and harness capabilities');
-    console.log('  integrations  Manage chat integrations (Slack)');
-    console.log('  chat       Simulate chat messages (gateway testing)');
-    console.log('  profile    Manage CLI profiles (API URL, defaults)');
-    console.log('  auth       Authentication (login, logout, status)');
-    console.log('  admin      User and identity management (invite)');
-    console.log('  skills     Install skills from skills.txt (openskills --universal)');
-    console.log('  system     System health and status checks');
-    console.log('');
-    console.log('Global options:');
-    console.log('  --help               Show help for command');
-    console.log('  --api-url <url>      Override API URL');
-    console.log('  --profile <name>     Use named repo profile');
-    console.log('  --org <id>           Override default org');
-    console.log('  --project <id>       Override default project');
-    console.log('  --json               Output as JSON');
-    console.log('');
-    console.log('Examples:');
-    console.log('  eve org ensure "My Company"');
-    console.log('  eve project ensure --name my-app --slug MyApp --repo-url https://github.com/org/repo');
-    console.log('  eve job create --description "Fix the bug in auth.ts"');
-    console.log('  eve job list --phase ready');
-    console.log('  eve job show MyProj-abc123');
-    console.log('');
-    console.log('Run "eve <command> --help" for more information on a command.');
-}
-function showCommandHelp(command) {
-    const help = exports.HELP[command];
-    if (!help) {
-        console.log(`Unknown command: ${command}`);
-        console.log('Run "eve --help" for available commands.');
-        return;
-    }
-    console.log(`eve ${command} - ${help.description.split('\n')[0]}`);
-    console.log('');
-    if (help.description.includes('\n')) {
-        console.log(help.description);
-        console.log('');
-    }
-    console.log(`Usage: ${help.usage}`);
-    console.log('');
-    if (help.subcommands) {
-        console.log('Subcommands:');
-        const maxLen = Math.max(...Object.keys(help.subcommands).map(k => k.length));
-        for (const [name, sub] of Object.entries(help.subcommands)) {
-            console.log(`  ${name.padEnd(maxLen + 2)} ${sub.description}`);
-        }
-        console.log('');
-    }
-    if (help.examples && help.examples.length > 0) {
-        console.log('Examples:');
-        help.examples.forEach(ex => console.log(`  ${ex}`));
-        console.log('');
-    }
-    console.log(`Run "eve ${command} <subcommand> --help" for subcommand details.`);
-}
-function showSubcommandHelp(command, subcommand) {
-    const cmdHelp = exports.HELP[command];
-    if (!cmdHelp) {
-        console.log(`Unknown command: ${command}`);
-        return;
-    }
-    const subHelp = cmdHelp.subcommands?.[subcommand];
-    if (!subHelp) {
-        console.log(`Unknown subcommand: ${command} ${subcommand}`);
-        console.log(`Run "eve ${command} --help" for available subcommands.`);
-        return;
-    }
-    console.log(`eve ${command} ${subcommand} - ${subHelp.description}`);
-    console.log('');
-    console.log(`Usage: ${subHelp.usage}`);
-    if (subHelp.options && subHelp.options.length > 0) {
-        console.log('');
-        console.log('Options:');
-        subHelp.options.forEach(opt => console.log(`  ${opt}`));
-    }
-    if (subHelp.examples && subHelp.examples.length > 0) {
-        console.log('');
-        console.log('Examples:');
-        subHelp.examples.forEach(ex => console.log(`  ${ex}`));
-    }
-}
-function shouldShowHelp(subcommand, flags) {
-    if (flags.help || flags.h) {
-        return subcommand ? 'subcommand' : 'command';
-    }
-    if (subcommand === '--help' || subcommand === '-h') {
-        return 'command';
-    }
-    if (!subcommand) {
-        return 'command';
-    }
-    return false;
-}