ccs/tests/unit/commands/help-command-parity.test.ts

import { afterEach, describe, expect, test } from 'bun:test';

import { handleHelpCommand } from '../../../src/commands/help-command';

function stripAnsi(input: string): string {
  return input.replace(/\u001b\[[0-9;]*m/g, '');
}

describe('help command parity', () => {
  const originalLog = console.log;

  afterEach(() => {
    console.log = originalLog;
  });

  test('root help documents cliproxy provider filter under quota command', async () => {
    const lines: string[] = [];
    console.log = (...args: unknown[]) => {
      lines.push(args.map((arg) => String(arg)).join(' '));
    };

    await handleHelpCommand();

    const rendered = stripAnsi(lines.join('\n'));
    expect(rendered.includes('ccs cliproxy status [provider]')).toBe(false);
    expect(rendered.includes('ccs cliproxy status')).toBe(true);
    expect(rendered.includes('ccs cliproxy quota --provider <name>')).toBe(true);
    expect(rendered.includes('ccs llamacpp')).toBe(true);
  });

  test('root help documents llama.cpp as a local API profile', async () => {
    const lines: string[] = [];
    console.log = (...args: unknown[]) => {
      lines.push(args.map((arg) => String(arg)).join(' '));
    };

    await handleHelpCommand();

    const rendered = stripAnsi(lines.join('\n'));
    expect(rendered.includes('ccs llamacpp')).toBe(true);
    expect(rendered.includes('http://127.0.0.1:8080')).toBe(true);
  });

  test('root help no longer markets glmt as a supported profile', async () => {
    const lines: string[] = [];
    console.log = (...args: unknown[]) => {
      lines.push(args.map((arg) => String(arg)).join(' '));
    };

    await handleHelpCommand();

    const rendered = stripAnsi(lines.join('\n'));
    expect(rendered.includes('ccs glmt')).toBe(false);
    expect(rendered.includes('ccs glm')).toBe(true);
  });

  test('root help documents Claude IDE extension setup surfaces', async () => {
    const lines: string[] = [];
    console.log = (...args: unknown[]) => {
      lines.push(args.map((arg) => String(arg)).join(' '));
    };

    await handleHelpCommand();

    const rendered = stripAnsi(lines.join('\n'));
    expect(rendered.includes('Claude IDE Extension setup page')).toBe(true);
    expect(rendered.includes('ccs env <profile> --format claude-extension --ide vscode')).toBe(
      true
    );
    expect(rendered.includes('ccs env <profile> --format claude-extension --ide windsurf')).toBe(
      true
    );
  });

  test('root help documents dashboard host binding example', async () => {
    const lines: string[] = [];
    console.log = (...args: unknown[]) => {
      lines.push(args.map((arg) => String(arg)).join(' '));
    };

    await handleHelpCommand();

    const rendered = stripAnsi(lines.join('\n'));
    expect(rendered.includes('ccs config --host 0.0.0.0')).toBe(true);
    expect(rendered.includes('Force all-interface binding for remote devices')).toBe(true);
  });

  test('root help documents official channels native-only scope and process-env tokens', async () => {
    const lines: string[] = [];
    console.log = (...args: unknown[]) => {
      lines.push(args.map((arg) => String(arg)).join(' '));
    };

    await handleHelpCommand();

    const rendered = stripAnsi(lines.join('\n'));
    expect(rendered.includes('Dashboard -> Settings -> Channels (fastest path)')).toBe(true);
    expect(
      rendered.includes('Fastest path: turn on the channel, save the token if needed, then run ccs.')
    ).toBe(true);
    expect(rendered.includes('Not supported for ccs glm')).toBe(true);
    expect(rendered.includes('Current-process TELEGRAM_BOT_TOKEN / DISCORD_BOT_TOKEN also work')).toBe(
      true
    );
  });
});