import { APP_NAME, CONFIG_DIR_NAME } from "@gajae-code/utils/dirs";

export function getExtraHelpText(): string {
	return `Commands:
  ${APP_NAME} [prompt]             - Start an interactive coding session (default launch command)
  ${APP_NAME} launch               - Start an explicit launch/session workflow
  ${APP_NAME} setup                - Install GJC defaults or optional dependencies
  ${APP_NAME} session              - List, inspect, create, remove, or attach sessions
  ${APP_NAME} state                - Inspect or manage persisted GJC state
  ${APP_NAME} auth-broker         - Manage the auth-broker (credential vault)
  ${APP_NAME} accounts             - List, check, pin, and remove stored OAuth accounts
  ${APP_NAME} auth-gateway        - Run an auth-gateway forward proxy
  ${APP_NAME} harness              - Run harness control-plane commands
  ${APP_NAME} coordinator          - Manage coordinator/runtime coordination helpers
  ${APP_NAME} ultragoal            - Run durable goal execution workflow
  ${APP_NAME} ralplan              - Run consensus planning workflow
  ${APP_NAME} autoresearch         - Run autonomous research workflow
  ${APP_NAME} deep-interview       - Run requirements interview workflow
  ${APP_NAME} skills               - List/read embedded workflow skills
  ${APP_NAME} config               - List, get, and set configuration values
  ${APP_NAME} stats                - View AI usage statistics (tokens, cost, requests)
  ${APP_NAME} notify               - Send or test notifications
  ${APP_NAME} daemon               - Manage background daemon helpers
  ${APP_NAME} mcp                  - Manage MCP server registrations
  ${APP_NAME} mcp-serve            - Serve the MCP integration endpoint
  ${APP_NAME} contribute-pr        - Prepare contribution/PR workflow artifacts
  ${APP_NAME} migrate              - Run migration helpers
  ${APP_NAME} update               - Update GJC installation artifacts
  ${APP_NAME} plugin               - Install, remove, and list plugins
  ${APP_NAME} web-search           - Search the web from the CLI (alias: q)
  ${APP_NAME} codex-native-hook    - Run Codex native hook integration
  ${APP_NAME} gc                   - Run garbage-collection/cleanup helpers
  ${APP_NAME} quick-lane         - Classify a task into quick lane or deep path
  ${APP_NAME} <command> --help     - Show command-specific help

Environment Variables:
  # Core Providers
  ANTHROPIC_API_KEY          - Anthropic Claude models
  ANTHROPIC_OAUTH_TOKEN      - Anthropic OAuth (takes precedence over API key)
  CLAUDE_CODE_USE_FOUNDRY    - Enable Anthropic Foundry mode (uses Foundry endpoint + mTLS)
  FOUNDRY_BASE_URL           - Anthropic Foundry base URL (e.g., https://<foundry-host>)
  ANTHROPIC_FOUNDRY_API_KEY  - Anthropic token used as Authorization: Bearer <token> in Foundry mode
  ANTHROPIC_CUSTOM_HEADERS   - Extra Foundry headers (e.g., "user-id: USERNAME")
  CLAUDE_CODE_CLIENT_CERT    - Client certificate (PEM path or inline PEM) for mTLS
  CLAUDE_CODE_CLIENT_KEY     - Client private key (PEM path or inline PEM) for mTLS
  NODE_EXTRA_CA_CERTS        - CA bundle path (or inline PEM) for server certificate validation
  OPENAI_API_KEY             - OpenAI GPT models
  GEMINI_API_KEY             - Google Gemini models
  GITHUB_TOKEN               - GitHub Copilot (or GH_TOKEN, COPILOT_GITHUB_TOKEN)

  # Additional LLM Providers
  AZURE_OPENAI_API_KEY       - Azure OpenAI models
  GROQ_API_KEY               - Groq models
  CEREBRAS_API_KEY           - Cerebras models
  XAI_API_KEY                - xAI Grok models
  OPENROUTER_API_KEY         - OpenRouter aggregated models
  KILO_API_KEY               - Kilo Gateway models
  MISTRAL_API_KEY            - Mistral models
  ZAI_API_KEY                - z.ai models (ZhipuAI/GLM)
  JUNIE_API_KEY              - JetBrains AI models (Junie; Claude via JetBrains AI)
  MINIMAX_API_KEY            - MiniMax models
  OPENCODE_API_KEY           - OpenCode Zen/OpenCode Go models
  CURSOR_ACCESS_TOKEN        - Cursor AI models
  AI_GATEWAY_API_KEY         - Vercel AI Gateway

  # Cloud Providers
  AWS_PROFILE                - AWS Bedrock (or AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY)
  GOOGLE_CLOUD_PROJECT       - Google Vertex AI (requires GOOGLE_CLOUD_LOCATION)
  GOOGLE_APPLICATION_CREDENTIALS - Service account for Vertex AI

  # Search & Tools
  EXA_API_KEY                - Exa web search
  BRAVE_API_KEY              - Brave web search
  PERPLEXITY_API_KEY         - Perplexity web search (API)
  PERPLEXITY_COOKIES         - Perplexity web search (session cookie)
  TAVILY_API_KEY             - Tavily web search
  ANTHROPIC_SEARCH_API_KEY   - Anthropic search provider

  # Configuration
  GJC_CODING_AGENT_DIR       - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
  GJC_PACKAGE_DIR            - Override package directory (for Nix/Guix store paths)
  GJC_SMOL_MODEL              - Override smol/fast model (see --smol)
  GJC_SLOW_MODEL              - Override slow/reasoning model (see --slow)
  GJC_PLAN_MODEL              - Override planning model (see --plan)
  GJC_NO_PTY                  - Disable PTY-based interactive bash execution
  --tmux                       - Launch interactive startup inside a fresh tmux session
  gjc session                  - List, inspect, create, remove, or attach tagged GJC-managed tmux sessions
  GJC_LAUNCH_POLICY           - Launch policy for --tmux startup: tmux or direct
  GJC_TMUX_SESSION            - Explicit tmux session name override for --tmux startup
  GJC_TMUX_PROFILE            - Apply GJC tmux scroll/mouse/clipboard profile to --tmux sessions (set 0/off to skip)
  GJC_MOUSE                   - Apply tmux copy-mode mouse capture in --tmux sessions (set 0/off to skip)

  For complete environment variable reference, see:
  docs/environment-variables.md
Available Tools (default-enabled unless noted):
  read          - Read file contents
  bash          - Execute bash commands
  edit          - Edit files with find/replace
  write         - Write files (creates/overwrites)
  search        - Search file contents
  find          - Find files by glob pattern
  lsp           - Language server protocol (code intelligence)
  python        - Execute Python code (requires: ${APP_NAME} setup python)
  notebook      - Edit Jupyter notebooks
  browser       - Browser automation (Puppeteer)
  task          - Launch sub-agents for parallel tasks
  todo_write    - Manage todo/task lists
  web_search    - Search the web
  ask           - Ask user questions (interactive mode only)

Useful Commands:
  ${APP_NAME} --list-models        - List configured provider models
  ${APP_NAME} models               - Alias for --list-models (never starts an agent)
  ${APP_NAME} --help               - Show this help`;
}