@kaitranntt/ccs 7.65.3-dev.1 → 7.65.3-dev.10

package/dist/commands/help-command.js

@@ -22,530 +22,178 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleHelpCommand = void 0;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
+exports.getRootHelpCatalogEntries = exports.getRootHelpVisibleCommands = exports.handleHelpRoute = exports.handleHelpCommand = void 0;
+const package_json_1 = __importDefault(require("../../package.json"));
 const ui_1 = require("../utils/ui");
-const unified_config_loader_1 = require("../config/unified-config-loader");
-const config_manager_1 = require("../utils/config-manager");
-const port_manager_1 = require("../cliproxy/config/port-manager");
-const official_channels_runtime_1 = require("../channels/official-channels-runtime");
-// Get version from package.json (same as version-command.ts)
-const VERSION = JSON.parse(fs.readFileSync(path.join(__dirname, '../../package.json'), 'utf8')).version;
-/**
- * Print a major section with ═══ borders (only for 3 main sections)
- * Format:
- *   ═══ TITLE ═══
- *   Subtitle line 1
- *   Subtitle line 2
- *
- *   command    Description
- */
-function printMajorSection(title, subtitles, items, writeLine = console.log) {
-    // Section header with ═══ borders
-    writeLine((0, ui_1.sectionHeader)(title));
-    // Subtitles on separate lines (dim)
-    for (const subtitle of subtitles) {
-        writeLine(`  ${(0, ui_1.dim)(subtitle)}`);
-    }
-    // Empty line before items
-    writeLine('');
-    // Calculate max command length for alignment
-    const maxCmdLen = Math.max(...items.map(([cmd]) => cmd.length));
-    for (const [cmd, desc] of items) {
-        const paddedCmd = cmd.padEnd(maxCmdLen + 2);
-        writeLine(`  ${(0, ui_1.color)(paddedCmd, 'command')} ${desc}`);
-    }
-    // Extra spacing after section
-    writeLine('');
+const command_catalog_1 = require("./command-catalog");
+function getTopicSummary(name) {
+    return command_catalog_1.ROOT_HELP_TOPICS.find((topic) => topic.name === name)?.summary || '';
 }
-/**
- * Print a sub-section with colored title
- * Format:
- *   Title (context):
- *     command    Description
- */
-function printSubSection(title, items, writeLine = console.log) {
-    // Sub-section header (colored, no borders)
-    writeLine((0, ui_1.subheader)(`${title}:`));
-    // Calculate max command length for alignment
-    const maxCmdLen = Math.max(...items.map(([cmd]) => cmd.length));
-    for (const [cmd, desc] of items) {
-        const paddedCmd = cmd.padEnd(maxCmdLen + 2);
-        writeLine(`  ${(0, ui_1.color)(paddedCmd, 'command')} ${desc}`);
+function writeCommandTable(title, entries, writeLine) {
+    writeLine((0, ui_1.subheader)(title));
+    const maxWidth = Math.max(...entries.map((entry) => entry.name.length));
+    for (const entry of entries) {
+        writeLine(`  ${(0, ui_1.color)(entry.name.padEnd(maxWidth + 2), 'command')} ${entry.summary}`);
     }
-    // Spacing after section
     writeLine('');
 }
-/**
- * Print a config/paths section
- * Format:
- *   Title:
- *     Label:    path
- */
-function printConfigSection(title, items, writeLine = console.log) {
-    writeLine((0, ui_1.subheader)(`${title}:`));
-    // Calculate max label length for alignment
-    const maxLabelLen = Math.max(...items.map(([label]) => label.length));
-    for (const [label, path] of items) {
-        const paddedLabel = label.padEnd(maxLabelLen);
-        writeLine(`  ${paddedLabel} ${(0, ui_1.color)(path, 'path')}`);
-    }
-    writeLine('');
+function writeGroupedCommands(group, writeLine) {
+    const entries = (0, command_catalog_1.getPublicRootCommands)()
+        .filter((entry) => entry.group === group)
+        .map((entry) => ({ name: entry.name, summary: entry.summary }));
+    const titles = {
+        start: 'Start Here',
+        manage: 'Profile Management',
+        operations: 'Operations',
+        runtime: 'Compatible Runtimes',
+    };
+    writeCommandTable(titles[group], entries, writeLine);
 }
-/**
- * Display comprehensive help information for CCS (Claude Code Switch)
- */
-async function handleHelpCommand(writeLine = console.log) {
-    // Initialize UI (if not already)
+async function showProfilesHelp(writeLine) {
     await (0, ui_1.initUI)();
-    // Hero box with ASCII art logo and config hint
-    // Each letter: C=╔═╗/║ /╚═╝, C=╔═╗/║ /╚═╝, S=╔═╗/╚═╗/╚═╝
-    const logo = `
-╔═╗ ╔═╗ ╔═╗
-║   ║   ╚═╗  v${VERSION}
-╚═╝ ╚═╝ ╚═╝
-
-Claude Code Profile & Model Switcher
-
-Run ${(0, ui_1.color)('ccs config', 'command')} for web dashboard`.trim();
-    writeLine((0, ui_1.box)(logo, {
-        padding: 1,
-        borderStyle: 'round',
-        titleAlignment: 'center',
-    }));
+    writeLine((0, ui_1.header)('CCS Profiles Help'));
     writeLine('');
-    // Resolve display path for dynamic sections
-    const [dirSource] = (0, config_manager_1.getCcsDirSource)();
-    const dirDisplay = dirSource === 'default' ? '~/.ccs' : (0, config_manager_1.getCcsDir)();
-    // Usage section
-    writeLine((0, ui_1.subheader)('Usage:'));
-    writeLine(`  ${(0, ui_1.color)('ccs', 'command')} [profile] [claude-args...]`);
-    writeLine(`  ${(0, ui_1.color)('ccs', 'command')} [flags]`);
+    writeCommandTable('Profile Types', [
+        { name: 'ccs auth create <name>', summary: 'Concurrent Claude account profile' },
+        { name: 'ccs api create', summary: 'API-backed settings profile' },
+        { name: 'ccs cliproxy create <name>', summary: 'Named CLIProxy variant profile' },
+        { name: 'ccs env <profile>', summary: 'Export an existing profile for other tools' },
+    ], writeLine);
+    writeCommandTable('Examples', command_catalog_1.ROOT_PROFILE_EXAMPLES, writeLine);
+    writeLine(`  ${(0, ui_1.dim)('Deep help: ccs auth --help | ccs api --help | ccs cliproxy --help')}`);
     writeLine('');
-    // ═══════════════════════════════════════════════════════════════════════════
-    // MAJOR SECTION 1: API Key Profiles
-    // ═══════════════════════════════════════════════════════════════════════════
-    printMajorSection('API Key Profiles', [`Configure in ${dirDisplay}/*.settings.json`], [
-        ['ccs', 'Use default Claude account'],
-        ['ccs glm', 'GLM 5 (API key required)'],
-        ['ccs km', 'Kimi for Coding (API key)'],
-        [
-            'ccs api create --preset alibaba-coding-plan',
-            'Alibaba Coding Plan (Anthropic-compatible API key)',
-        ],
-        ['ccs ollama', 'Local Ollama (http://localhost:11434)'],
-        ['ccs llamacpp', 'Local llama.cpp (http://127.0.0.1:8080)'],
-        ['ccs ollama-cloud', 'Ollama Cloud (API key required)'],
-        ['', ''], // Spacer
-        ['ccs api create --preset anthropic', 'Anthropic direct API key (sk-ant-...)'],
-        [
-            'ccs api create --cliproxy-provider gemini',
-            'Create routed API profile from CLIProxy Gemini',
-        ],
-        ['ccs api create', 'Create custom API profile'],
-        ['ccs api discover --register', 'Discover/register orphan settings files'],
-        ['ccs api copy <src> <dest>', 'Duplicate API profile'],
-        ['ccs api export <name>', 'Export profile bundle'],
-        ['ccs api import <file>', 'Import profile bundle'],
-        ['ccs api remove', 'Remove an API profile'],
-        ['ccs api list', 'List all API profiles'],
-    ], writeLine);
-    // ═══════════════════════════════════════════════════════════════════════════
-    // MAJOR SECTION 2: Account Management
-    // ═══════════════════════════════════════════════════════════════════════════
-    printMajorSection('Account Management', ['Run multiple Claude accounts concurrently'], [
-        ['ccs auth --help', 'Show account management commands'],
-        [
-            'ccs auth create <name>',
-            'Create account profile (supports --bare, shared groups, --deeper-continuity)',
-        ],
-        ['ccs config', 'Dashboard: Accounts table can edit context mode/group/continuity depth'],
-        [
-            '~/.ccs/config.yaml',
-            'Optional: continuity.inherit_from_account maps API/CLIProxy/copilot/default profiles to an account context',
-        ],
-        ['ccs auth list', 'List all account profiles'],
-        ['ccs auth default <name>', 'Set default profile'],
-        ['ccs auth reset-default', 'Restore original CCS default'],
-        ['ccs cliproxy auth claude', 'Alternative: authenticate Claude account pool via CLIProxy'],
-    ], writeLine);
-    // ═══════════════════════════════════════════════════════════════════════════
-    // MAJOR SECTION 3: CLI Proxy (OAuth Providers)
-    // ═══════════════════════════════════════════════════════════════════════════
-    printMajorSection('CLI Proxy Plus (OAuth Providers)', [
-        'Zero-config OAuth authentication via CLIProxy Plus',
-        'First run: Browser opens for authentication, then model selection',
-        'Settings: ~/.ccs/{provider}.settings.json (created after auth)',
-        'Safety: do not reuse one Google account across "ccs gemini" and "ccs agy" (issue #509)',
-        'Antigravity requires multi-step responsibility confirmation (issue #509)',
-        'If you want to keep Google AI access, do not continue this shared-account setup',
-        'CCS is as-is and does not take responsibility for account bans/access loss',
-    ], [
-        ['ccs gemini', 'Google Gemini (gemini-2.5-pro or 3-pro)'],
-        ['ccs codex', 'OpenAI Codex (supports -medium/-high/-xhigh model suffixes)'],
-        ['ccs agy', 'Antigravity (Claude/Gemini models)'],
-        ['ccs qwen', 'Qwen Code OAuth (CLIProxy)'],
-        ['ccs kimi', 'Kimi (Moonshot AI K2/K2.5 models)'],
-        ['ccs kiro', 'Kiro (AWS CodeWhisperer Claude models)'],
-        ['ccs ghcp', 'GitHub Copilot (OAuth via CLIProxy Plus)'],
-        ['', ''], // Spacer
-        ['ccs <provider> --auth', 'Authenticate only'],
-        ['ccs <provider> --auth --add', 'Add another account'],
-        [
-            'ccs <provider> --paste-callback',
-            'Show auth URL and prompt for callback paste (cross-browser)',
-        ],
-        ['ccs <provider> --accounts', 'List all accounts'],
-        ['ccs <provider> --use <nickname-or-id>', 'Switch to account'],
-        ['ccs <provider> --config', 'Change model (agy, gemini)'],
-        [
-            'ccs agy --accept-agr-risk',
-            'Bypass interactive Antigravity confirmation (you accept full responsibility)',
-        ],
-        [
-            'ccs <provider> --thinking <value>',
-            'Set thinking budget (low/medium/high/xhigh/auto/off or number)',
-        ],
-        ['ccs codex --effort <level>', 'Set codex reasoning effort (minimal/low/medium/high/xhigh)'],
-        ['ccs <provider> --1m', 'Request explicit 1M context when the selected model supports [1m]'],
-        ['ccs <provider> --no-1m', 'Force standard context / clear [1m]'],
-        ['ccs <provider> --logout', 'Clear authentication'],
-        ['ccs <provider> --headless', 'Headless auth (for SSH)'],
-        ['ccs <provider> --port-forward', 'Force port-forwarding mode (skip prompt)'],
-        ['ccs kiro --auth --kiro-auth-method aws', 'Kiro via AWS Builder ID (device code)'],
-        ['ccs kiro --auth --kiro-auth-method aws-authcode', 'Kiro via AWS auth code flow'],
-        ['ccs kiro --auth --kiro-auth-method google', 'Kiro via Google OAuth'],
-        ['ccs kiro --auth --kiro-auth-method github', 'Kiro via GitHub OAuth (Dashboard flow)'],
-        ['ccs kiro --import', 'Import token from Kiro IDE'],
-        ['ccs kiro --incognito', 'Use incognito browser (default: normal)'],
-        ['ccs codex "explain code"', 'Use with prompt'],
-    ], writeLine);
-    // ═══════════════════════════════════════════════════════════════════════════
-    // MAJOR SECTION 4: GitHub Copilot Integration (copilot-api)
-    // ═══════════════════════════════════════════════════════════════════════════
-    printMajorSection('GitHub Copilot Integration (copilot-api)', [
-        'Use your GitHub Copilot subscription with Claude Code via copilot-api',
-        'Requires: npm install -g copilot-api',
-        'Note: For OAuth-based access, use ccs ghcp instead',
-    ], [
-        ['ccs copilot', 'Use Copilot via copilot-api daemon'],
-        ['ccs copilot auth', 'Authenticate with GitHub'],
-        ['ccs copilot status', 'Show integration status'],
-        ['ccs copilot models', 'List available models'],
-        ['ccs copilot usage', 'Show Copilot quota usage'],
-        ['ccs copilot start', 'Start copilot-api daemon'],
-        ['ccs copilot stop', 'Stop copilot-api daemon'],
-        ['ccs copilot enable', 'Enable integration'],
-        ['ccs copilot disable', 'Disable integration'],
-    ], writeLine);
-    // ═══════════════════════════════════════════════════════════════════════════
-    // MAJOR SECTION 5: Cursor IDE Integration
-    // ═══════════════════════════════════════════════════════════════════════════
-    printMajorSection('Cursor IDE Integration', [
-        'Use Cursor IDE with Claude Code via cursor proxy daemon',
-        'Auto-detects token from Cursor installation',
-    ], [
-        ['ccs cursor <cmd>', 'Use Cursor IDE integration'],
-        ['ccs cursor auth', 'Import Cursor token'],
-        ['ccs cursor auth --manual --token <t> --machine-id <id>', 'Manual token import'],
-        ['ccs cursor status', 'Show connection status'],
-        ['ccs cursor models', 'List available models'],
-        ['ccs cursor start', 'Start proxy daemon'],
-        ['ccs cursor stop', 'Stop proxy daemon'],
-        ['ccs cursor enable', 'Enable cursor integration'],
-        ['ccs cursor disable', 'Disable cursor integration'],
-    ], writeLine);
-    // ═══════════════════════════════════════════════════════════════════════════
-    // SUB-SECTIONS (simpler styling)
-    // ═══════════════════════════════════════════════════════════════════════════
-    // Delegation
-    printSubSection('Delegation (inside Claude Code CLI)', [
-        ['/ccs "task"', 'Delegate task (auto-selects profile)'],
-        ['/ccs --glm "task"', 'Force GLM-5 for simple tasks'],
-        ['/ccs --kimi "task"', 'Force Kimi OAuth for long context'],
-        ['/ccs --km "task"', 'Force Kimi API key for long context'],
-        ['/ccs:continue "follow-up"', 'Continue last delegation session'],
-    ], writeLine);
-    // Delegation CLI Flags (Claude Code passthrough)
-    printSubSection('Delegation Flags (Claude Code passthrough)', [
-        ['--max-turns <n>', 'Limit agentic turns (prevents loops)'],
-        ['--fallback-model <model>', 'Auto-fallback on overload (sonnet)'],
-        ['--agents <json>', 'Inject dynamic subagents'],
-        ['--betas <features>', 'Enable experimental features'],
-        ['--allowedTools <list>', 'Restrict available tools'],
-        ['--disallowedTools <list>', 'Block specific tools'],
-    ], writeLine);
-    // Diagnostics
-    printSubSection('Diagnostics', [
-        ['ccs setup', 'First-time setup wizard'],
-        ['ccs doctor', 'Run health check and diagnostics'],
-        ['ccs cleanup', 'Remove old CLIProxy logs'],
-        ['ccs config', 'Open web dashboard (includes Claude IDE Extension setup page)'],
-        ['ccs config auth setup', 'Configure dashboard login'],
-        ['ccs config auth show', 'Show dashboard auth status'],
-        ['ccs config channels', 'Show Official Channels status'],
-        [
-            'ccs config channels --set telegram,discord',
-            'Auto-add Telegram + Discord on supported native Claude runs',
-        ],
-        ['ccs config channels --set-token telegram=<token>', 'Save TELEGRAM_BOT_TOKEN'],
-        ['ccs config image-analysis', 'Show image analysis settings'],
-        ['ccs config image-analysis --enable', 'Enable image analysis'],
-        ['ccs config thinking', 'Show thinking/reasoning settings'],
-        ['ccs config thinking --mode auto', 'Set thinking mode'],
-        ['ccs config thinking --clear-provider-override codex', 'Clear provider overrides'],
-        ['ccs config --port 3000', 'Use specific port'],
-        ['ccs config --host 0.0.0.0', 'Force all-interface binding for remote devices'],
-        ['ccs persist <profile>', 'Write profile setup to ~/.claude/settings.json'],
-        ['ccs persist --list-backups', 'List available settings.json backups'],
-        ['ccs persist --restore', 'Restore settings.json from latest backup'],
-        ['ccs sync', 'Sync delegation commands and skills'],
-        ['ccs update', 'Update CCS to latest version'],
-        ['ccs update --force', 'Force reinstall current version'],
-        ['ccs update --beta', 'Install from dev channel (unstable)'],
-    ], writeLine);
-    // Environment export
-    printSubSection('Environment Export', [
-        ['ccs env <profile>', 'Export env vars for third-party tools'],
-        ['ccs env <profile> --format openai', 'OpenAI-compatible vars (OpenCode/Cursor)'],
-        ['ccs env <profile> --format anthropic', 'Anthropic vars (default)'],
-        ['ccs env <profile> --format raw', 'All effective env vars'],
-        [
-            'ccs env <profile> --format claude-extension --ide vscode',
-            'VS Code/Cursor Claude extension settings JSON',
-        ],
-        [
-            'ccs env <profile> --format claude-extension --ide windsurf',
-            'Windsurf Claude extension settings JSON',
-        ],
-        ['ccs env <profile> --shell fish', 'Fish shell syntax'],
-    ], writeLine);
-    // Flags
-    printSubSection('Flags', [
-        ['--config-dir <path>', 'Use custom CCS config directory'],
-        ['--target <cli>', 'Target CLI: claude (default), droid, codex (runtime-only)'],
-        ['-h, --help', 'Show this help message'],
-        ['-v, --version', 'Show version and installation info'],
-        ['-sc, --shell-completion', 'Install shell auto-completion'],
-    ], writeLine);
-    // Aliases
-    printSubSection('Aliases', [
-        ['ccs-droid <profile> [args]', 'Explicit Droid runtime alias'],
-        ['ccsd <profile> [args]', 'Legacy shortcut for: ccs-droid <profile> [args]'],
-        ['ccs-codex <profile> [args]', 'Explicit Codex runtime alias'],
-        ['ccsx <profile> [args]', 'Short alias for: ccs-codex <profile> [args]'],
-        ['ccsxp [args]', 'Shortcut for: ccs codex --target codex [args]'],
-    ], writeLine);
-    // Multi-target examples
-    printSubSection('Multi-Target', [
-        ['ccs glm --target droid', 'Run GLM profile on Droid CLI'],
-        ['ccs-droid glm', 'Same as above (explicit alias)'],
-        ['ccsd glm', 'Legacy shortcut for ccs-droid'],
-        ['ccs --target codex', 'Open a native Codex session with your existing ~/.codex setup'],
-        ['ccs-codex', 'Same as above (explicit Codex alias)'],
-        ['ccsx', 'Short alias for ccs-codex'],
-        ['ccsxp "your prompt"', 'Run built-in CLIProxy Codex on native Codex CLI'],
-        ['ccs codex --target codex', 'Explicit form of ccsxp'],
-        [
-            'ccs api create codex-api --cliproxy-provider codex',
-            'Create a routed API bridge that can also run on Codex',
-        ],
-        ['ccs codex-api --target codex', 'Run a Codex bridge profile on native Codex CLI'],
-        ['ccs-droid codex', 'Run built-in CLIProxy Codex profile on Droid'],
-        ['ccs-droid agy', 'Run built-in CLIProxy Antigravity profile on Droid'],
-        [
-            'ccs-droid codex exec --skip-permissions-unsafe "fix failing tests"',
-            'Pass through Droid exec mode',
-        ],
-        [
-            'ccs-droid codex -m custom:gpt-5.3-codex "fix failing tests"',
-            'Auto-routes short exec flags',
-        ],
-        [
-            'ccs-droid codex --skip-permissions-unsafe "fix failing tests"',
-            'Auto-routes to Droid exec when exec-only flags are detected',
-        ],
-        [
-            'ccs cliproxy create my-codex --provider codex --target droid',
-            'Create CLIProxy variant with Droid as default target',
-        ],
-        ['ccs glm', 'Run GLM profile on Claude Code (default)'],
-    ], writeLine);
-    printSubSection('Codex + CLIProxy', [
-        ['ccsxp "your prompt"', 'Use the built-in CCS Codex provider shortcut on native Codex'],
-        ['ccs config', 'Open Compatible -> Codex CLI for native Codex setup and diagnostics'],
-        [
-            'Default provider',
-            'Set to cliproxy if plain codex or a personal cxp alias should use CLIProxy',
-        ],
-        ['Model provider auth', 'Save cliproxy with env_key = "CLIPROXY_API_KEY"'],
-    ], writeLine);
-    // Configuration
-    printConfigSection('Configuration', [
-        ['Config File:', (0, unified_config_loader_1.isUnifiedMode)() ? `${dirDisplay}/config.yaml` : `${dirDisplay}/config.json`],
-        ['Profiles:', `${dirDisplay}/profiles.json`],
-        ['Instances:', `${dirDisplay}/instances/`],
-        ['Settings:', `${dirDisplay}/*.settings.json`],
-    ], writeLine);
-    // CLI Proxy management
-    printSubSection('CLI Proxy Plus Management', [
-        ['ccs cliproxy', 'Show CLIProxy Plus status and version'],
-        ['ccs cliproxy --help', 'Full CLIProxy Plus management help'],
-        ['ccs cliproxy doctor', 'Quota diagnostics (Antigravity)'],
-        ['ccs cliproxy --install <ver>', 'Install specific version (e.g., 6.6.6)'],
-        ['ccs cliproxy --latest', 'Update to latest version'],
-        ['', ''], // Spacer
-        ['ccs cliproxy pause <p> <a>', 'Pause account from rotation'],
-        ['ccs cliproxy resume <p> <a>', 'Resume paused account'],
-        ['ccs cliproxy status', 'Show CLIProxy process status'],
-        ['ccs cliproxy quota', 'Show quota/tier/pause status for all providers'],
-        ['ccs cliproxy quota --provider <name>', 'Show quota/tier/pause status for one provider'],
-    ], writeLine);
-    printSubSection('Docker Deployment', [
-        ['ccs docker --help', 'Manage the integrated CCS + CLIProxy Docker stack'],
-        ['ccs docker up', 'Build and start the stack locally'],
-        ['ccs docker up --host <ssh>', 'Stage assets to ~/.ccs/docker and deploy remotely'],
-        ['ccs docker status', 'Show docker compose and supervisor status'],
-        ['ccs docker logs --follow', 'Tail combined CCS + CLIProxy logs'],
-        ['ccs docker update', 'Update CCS and CLIProxy inside the running container'],
-        ['ccs docker config', 'Show bundled asset paths and deployment defaults'],
-    ], writeLine);
-    // CLI Proxy configuration flags (new)
-    printSubSection('CLI Proxy Configuration', [
-        ['--proxy-host <host>', 'Remote proxy hostname/IP'],
-        ['--proxy-port <port>', `Proxy port (default: ${port_manager_1.CLIPROXY_DEFAULT_PORT})`],
-        ['--proxy-protocol <proto>', 'Protocol: http or https (default: http)'],
-        ['--proxy-auth-token <token>', 'Auth token for remote proxy'],
-        ['--proxy-timeout <ms>', 'Connection timeout in ms (default: 2000)'],
-        ['--local-proxy', 'Force local mode, ignore remote config'],
-        ['--remote-only', 'Fail if remote unreachable (no fallback)'],
-        ['--allow-self-signed', 'Allow self-signed certs (for dev proxies)'],
-    ], writeLine);
-    // W3: Thinking Budget explanation
-    printSubSection('Extended Thinking / Reasoning', [
-        ['--thinking off', 'Disable extended thinking'],
-        ['--thinking auto', 'Let model decide dynamically'],
-        ['--thinking low', '1K tokens - Quick responses'],
-        ['--thinking medium', '8K tokens - Standard analysis'],
-        ['--thinking high', '24K tokens - Deep reasoning'],
-        ['--thinking xhigh', '32K tokens - Maximum depth'],
-        ['--thinking <number>', 'Custom token budget (512-100000)'],
-        ['', ''],
-        ['--effort <level>', 'Codex alias for reasoning effort (minimal/low/medium/high/xhigh)'],
-        ['--effort xhigh', 'Pin Codex effort to xhigh for this run'],
-        ['', ''],
-        ['Droid exec:', 'Use native Droid flag: --reasoning-effort <level>'],
-        ['', 'CCS auto-maps --thinking/--effort to --reasoning-effort in droid exec mode.'],
-        ['', 'For interactive droid sessions, CCS applies reasoning via Droid BYOK model config.'],
-        ['', 'When multiple reasoning flags are provided, the first flag wins.'],
-        ['', ''],
-        ['Note:', 'Extended thinking allocates compute for step-by-step reasoning'],
-        ['', 'before responding.'],
-        ['', 'Providers: agy/gemini use --thinking, codex uses --effort (or --thinking alias).'],
-        ['', 'Codex model suffixes also pin effort: -medium / -high / -xhigh.'],
-    ], writeLine);
-    // Extended Context (1M)
-    printSubSection('Extended Context (--1m)', [
-        ['--1m', 'Request 1M token context when the selected model supports [1m]'],
-        ['--no-1m', 'Force standard context (Claude default stays plain)'],
-        ['', ''],
-        ['Auto behavior:', 'Gemini models: CCS auto-adds [1m] when supported'],
-        ['', 'Claude models: plain by default, opt-in with --1m or saved [1m]'],
-        ['', ''],
-        ['Note:', 'CCS only controls the saved [1m] suffix.'],
-        ['', 'Provider pricing and entitlement stay upstream.'],
-        [
-            '',
-            'Some accounts/providers can still return 429 extra-usage errors for long-context requests.',
-        ],
-    ], writeLine);
-    // Image Analysis
-    printSubSection('Image Analysis (first-class local tool)', [
-        ['ccs config image-analysis', 'Show current settings'],
-        ['ccs config image-analysis --enable', 'Enable for CLIProxy providers'],
-        ['ccs config image-analysis --disable', 'Disable (use native Read)'],
-        ['ccs config image-analysis --timeout 120', 'Set analysis timeout'],
-        ['ccs config image-analysis --set-model <p> <m>', 'Set provider model'],
-        ['', ''],
-        ['Note:', 'When ready, third-party launches expose the local ImageAnalysis MCP tool'],
-        ['', 'and route requests directly to the resolved CCS provider path.'],
-        ['', 'If runtime/auth/proxy is unavailable, CCS falls back to native Read.'],
-    ], writeLine);
-    printSubSection('Official Channels (official Claude plugins)', [
-        ['ccs config', 'Dashboard -> Settings -> Channels (fastest path)'],
-        ['ccs config channels', 'Show current status'],
-        [
-            'ccs config channels --set telegram,discord',
-            'Auto-add selected channels on native Claude default/account sessions',
-        ],
-        ['ccs config channels --set all', 'Enable Telegram, Discord, and iMessage'],
-        ['ccs config channels --unattended', 'Also add --dangerously-skip-permissions'],
-        ['ccs config channels --set-token telegram=<token>', 'Save TELEGRAM_BOT_TOKEN'],
-        ['ccs config channels --set-token discord=<token>', 'Save DISCORD_BOT_TOKEN'],
-        ['ccs config channels --clear-token [channel]', 'Remove one or all saved channel tokens'],
-        ['', ''],
-        ['', 'Fastest path: turn on the channel, save the token if needed, then run ccs.'],
-        ['Note:', (0, official_channels_runtime_1.getOfficialChannelsSupportMessage)()],
-        ['', 'Telegram/Discord tokens live in ~/.claude/channels/<channel>/.env.'],
-        ['', 'Current-process TELEGRAM_BOT_TOKEN / DISCORD_BOT_TOKEN also work for that launch.'],
-        ['', 'iMessage is macOS-only and requires local OS permissions instead of a bot token.'],
-    ], writeLine);
-    // CCS Environment Variables
-    printSubSection('Environment Variables', [
-        ['CCS_DIR', 'Override CCS config directory (default: ~/.ccs)'],
-        ['CCS_HOME', 'Override home directory (legacy, appends .ccs)'],
-        ['CCS_DEBUG', 'Enable debug logging'],
-        ['CCS_THINKING', 'Override thinking level (flag > env > config)'],
-    ], writeLine);
-    // CLI Proxy env vars
-    printSubSection('CLI Proxy Environment Variables', [
-        ['CCS_PROXY_HOST', 'Remote proxy hostname'],
-        ['CCS_PROXY_PORT', 'Proxy port'],
-        ['CCS_PROXY_PROTOCOL', 'Protocol (http/https)'],
-        ['CCS_PROXY_AUTH_TOKEN', 'Auth token'],
-        ['CCS_PROXY_TIMEOUT', 'Connection timeout in ms'],
-        ['CCS_PROXY_FALLBACK_ENABLED', 'Enable local fallback (1/0)'],
-        ['CCS_ALLOW_SELF_SIGNED', 'Allow self-signed certs (1/0)'],
-    ], writeLine);
-    // CLI Proxy paths
-    writeLine((0, ui_1.subheader)('CLI Proxy:'));
-    writeLine(`  Binary:      ${(0, ui_1.color)(`${dirDisplay}/cliproxy/bin/cli-proxy-api-plus`, 'path')}`);
-    writeLine(`  Config:      ${(0, ui_1.color)(`${dirDisplay}/cliproxy/config.yaml`, 'path')}`);
-    writeLine(`  Auth:        ${(0, ui_1.color)(`${dirDisplay}/cliproxy/auth/`, 'path')}`);
-    writeLine(`  ${(0, ui_1.dim)(`Port: ${port_manager_1.CLIPROXY_DEFAULT_PORT} (default)`)}`);
+}
+async function showProvidersHelp(writeLine) {
+    await (0, ui_1.initUI)();
+    writeLine((0, ui_1.header)('CCS Providers Help'));
     writeLine('');
-    // Shared Data
-    writeLine((0, ui_1.subheader)('Shared Data:'));
-    writeLine(`  Commands:    ${(0, ui_1.color)(`${dirDisplay}/shared/commands/`, 'path')}`);
-    writeLine(`  Skills:      ${(0, ui_1.color)(`${dirDisplay}/shared/skills/`, 'path')}`);
-    writeLine(`  Agents:      ${(0, ui_1.color)(`${dirDisplay}/shared/agents/`, 'path')}`);
-    writeLine(`  ${(0, ui_1.dim)('Note: Symlinked across all profiles')}`);
+    writeCommandTable('Built-in OAuth Providers', command_catalog_1.BUILTIN_PROVIDER_SHORTCUTS, writeLine);
+    writeCommandTable('Common Setup Paths', [
+        {
+            name: 'ccs <provider> --auth',
+            summary: 'Authenticate a provider account without launching',
+        },
+        { name: 'ccs api create --preset <id>', summary: 'Create an API-backed provider profile' },
+        { name: 'ccs config', summary: 'Use the dashboard for provider and model setup' },
+    ], writeLine);
+    writeLine(`  ${(0, ui_1.dim)('Deep help: ccs cliproxy --help | ccs api --help')}`);
     writeLine('');
-    // Examples (aligned with consistent spacing)
-    writeLine((0, ui_1.subheader)('Examples:'));
-    writeLine(`  $ ${(0, ui_1.color)('ccs', 'command')}                     ${(0, ui_1.dim)('# Use default account')}`);
-    writeLine(`  $ ${(0, ui_1.color)('ccs gemini', 'command')}              ${(0, ui_1.dim)('# OAuth (browser opens first time)')}`);
-    writeLine(`  $ ${(0, ui_1.color)('ccs glm "implement API"', 'command')} ${(0, ui_1.dim)('# API key model')}`);
-    writeLine(`  $ ${(0, ui_1.color)('ccs config', 'command')}              ${(0, ui_1.dim)('# Open web dashboard')}`);
+}
+async function showTargetsHelp(writeLine) {
+    await (0, ui_1.initUI)();
+    writeLine((0, ui_1.header)('CCS Targets Help'));
     writeLine('');
-    // Update examples
-    writeLine((0, ui_1.subheader)('Update:'));
-    writeLine(`  $ ${(0, ui_1.color)('ccs update', 'command')}              ${(0, ui_1.dim)('# Update to latest stable')}`);
-    writeLine(`  $ ${(0, ui_1.color)('ccs update --force', 'command')}      ${(0, ui_1.dim)('# Force reinstall current')}`);
-    writeLine(`  $ ${(0, ui_1.color)('ccs update --beta', 'command')}       ${(0, ui_1.dim)('# Install dev channel')}`);
+    writeCommandTable('Target Routing', command_catalog_1.ROOT_COMPATIBLE_ALIAS_EXAMPLES, writeLine);
+    writeCommandTable('Examples', [
+        { name: 'ccs glm --target droid', summary: 'Run a profile on Droid instead of Claude' },
+        {
+            name: 'ccs --target codex',
+            summary: 'Open a native Codex session with your current setup',
+        },
+        { name: 'ccs codex-api --target codex', summary: 'Run a routed API bridge on native Codex' },
+    ], writeLine);
+}
+async function handleHelpCommand(writeLine = console.log) {
+    await (0, ui_1.initUI)();
+    writeLine((0, ui_1.header)(`CCS CLI v${package_json_1.default.version}`));
     writeLine('');
-    // Docs link
-    writeLine(`  ${(0, ui_1.dim)('Docs: https://github.com/kaitranntt/ccs')}`);
+    writeLine('  Claude profile switching, provider routing, and compatible runtime bridges.');
     writeLine('');
-    // Uninstall
-    writeLine((0, ui_1.subheader)('Uninstall:'));
-    writeLine(`  ${(0, ui_1.color)('npm uninstall -g @kaitranntt/ccs', 'command')}`);
+    writeLine((0, ui_1.subheader)('Usage'));
+    writeLine(`  ${(0, ui_1.color)('ccs <profile> [claude-args...]', 'command')}`);
+    writeLine(`  ${(0, ui_1.color)('ccs <command> [options]', 'command')}`);
+    writeLine(`  ${(0, ui_1.color)('ccs help <topic>', 'command')}`);
     writeLine('');
-    // License
-    writeLine((0, ui_1.dim)('License: MIT'));
+    writeGroupedCommands('start', writeLine);
+    writeGroupedCommands('manage', writeLine);
+    writeGroupedCommands('runtime', writeLine);
+    writeGroupedCommands('operations', writeLine);
+    writeCommandTable('OAuth Provider Shortcuts', command_catalog_1.BUILTIN_PROVIDER_SHORTCUTS.map((entry) => ({
+        name: `ccs ${entry.name}`,
+        summary: entry.summary,
+    })), writeLine);
+    writeCommandTable('Examples', command_catalog_1.ROOT_PROFILE_EXAMPLES, writeLine);
+    writeCommandTable('Targets and Aliases', command_catalog_1.ROOT_COMPATIBLE_ALIAS_EXAMPLES, writeLine);
+    writeCommandTable('More Help', [
+        { name: 'ccs help profiles', summary: getTopicSummary('profiles') },
+        { name: 'ccs help providers', summary: getTopicSummary('providers') },
+        { name: 'ccs help completion', summary: getTopicSummary('completion') },
+        { name: 'ccs help targets', summary: getTopicSummary('targets') },
+        { name: 'ccs api --help', summary: 'Deep help for API profile lifecycle commands' },
+        { name: 'ccs cliproxy --help', summary: 'Deep help for variants, quota, and lifecycle' },
+        { name: 'ccs docker --help', summary: 'Deep help for Docker deployment commands' },
+        { name: 'ccs cursor --help', summary: 'Deep help for Cursor runtime/admin commands' },
+        { name: 'ccs copilot --help', summary: 'Deep help for GitHub Copilot commands' },
+    ], writeLine);
+    writeLine(`  ${(0, ui_1.dim)('Flags: -h/--help, -v/--version, -sc/--shell-completion, --target <cli>')}`);
     writeLine('');
 }
 exports.handleHelpCommand = handleHelpCommand;
+function listHelpTargets() {
+    return command_catalog_1.ROOT_HELP_TOPICS.map((topic) => topic.name).join(', ');
+}
+async function handleHelpRoute(args, writeLine = console.log) {
+    const topic = args[0];
+    if (!topic) {
+        await handleHelpCommand(writeLine);
+        return;
+    }
+    if (topic === 'profiles') {
+        await showProfilesHelp(writeLine);
+        return;
+    }
+    if (topic === 'providers') {
+        await showProvidersHelp(writeLine);
+        return;
+    }
+    if (topic === 'targets') {
+        await showTargetsHelp(writeLine);
+        return;
+    }
+    if (topic === 'completion') {
+        const { showShellCompletionHelp } = await Promise.resolve().then(() => __importStar(require('./shell-completion-command')));
+        showShellCompletionHelp(writeLine);
+        return;
+    }
+    const commandHandlers = {
+        api: async () => (await Promise.resolve().then(() => __importStar(require('./api-command/help')))).showApiCommandHelp(writeLine),
+        auth: async () => {
+            const authModule = await Promise.resolve().then(() => __importStar(require('../auth/auth-commands')));
+            const AuthCommands = authModule.default;
+            await new AuthCommands().showHelp();
+        },
+        cleanup: async () => (await Promise.resolve().then(() => __importStar(require('./cleanup-command')))).handleCleanupCommand(['--help']),
+        cliproxy: async () => (await Promise.resolve().then(() => __importStar(require('./cliproxy/help-subcommand')))).showHelp(),
+        copilot: async () => process.exit(await (await Promise.resolve().then(() => __importStar(require('./copilot-command')))).handleCopilotCommand(['--help'])),
+        cursor: async () => process.exit(await (await Promise.resolve().then(() => __importStar(require('./cursor-command')))).handleCursorCommand(['--help'])),
+        docker: async () => (await Promise.resolve().then(() => __importStar(require('./docker/help-subcommand')))).showHelp(),
+        migrate: async () => (await Promise.resolve().then(() => __importStar(require('./migrate-command')))).printMigrateHelp(),
+        setup: async () => (await Promise.resolve().then(() => __importStar(require('./setup-command')))).handleSetupCommand(['--help']),
+        tokens: async () => process.exit(await (await Promise.resolve().then(() => __importStar(require('./tokens-command')))).handleTokensCommand(['--help'])),
+    };
+    const handler = commandHandlers[topic];
+    if (handler) {
+        await handler();
+        return;
+    }
+    await (0, ui_1.initUI)();
+    writeLine((0, ui_1.color)(`Unknown help topic or command: ${topic}`, 'error'));
+    writeLine('');
+    writeLine(`  ${(0, ui_1.dim)(`Available help topics: ${listHelpTargets()}`)}`);
+    writeLine('');
+    process.exitCode = 1;
+}
+exports.handleHelpRoute = handleHelpRoute;
+function getRootHelpVisibleCommands() {
+    return (0, command_catalog_1.getPublicRootCommands)().map((entry) => entry.name);
+}
+exports.getRootHelpVisibleCommands = getRootHelpVisibleCommands;
+function getRootHelpCatalogEntries() {
+    return command_catalog_1.ROOT_COMMAND_CATALOG;
+}
+exports.getRootHelpCatalogEntries = getRootHelpCatalogEntries;
 //# sourceMappingURL=help-command.js.map