fabro/lib/crates/fabro-cli/tests/it/cmd/fabro.rs

use fabro_test::{fabro_snapshot, test_context};

#[test]
fn help() {
    let context = test_context!();
    let mut cmd = context.command();
    cmd.arg("--help");
    fabro_snapshot!(context.filters(), cmd, @"
    success: true
    exit_code: 0
    ----- stdout -----
    Usage: fabro [OPTIONS] [COMMAND]

    Commands:
      run         Launch a workflow run
      create      Create a workflow run (allocate run dir, persist spec)
      start       Start a created workflow run on the server
      attach      Attach to a running or finished workflow run
      events      View the event log of a workflow run
      logs        View the raw worker tracing log of a workflow run
      resume      Resume an interrupted workflow run
      rewind      Rewind a workflow run to an earlier checkpoint
      fork        Fork a workflow run from an earlier checkpoint into a new run
      wait        Block until a workflow run completes
      steer       Steer a running agent mid-execution
      ask         Ask Fabro a read-only question about a run
      preflight   Validate run configuration without executing
      validate    Validate a workflow
      graph       Render a workflow graph as SVG
      artifact    Inspect and copy run artifacts (screenshots, reports, traces)
      dump        Export a run's durable state to a directory
      rm          Remove one or more workflow runs
      inspect     Show detailed information about a workflow run
      approve     Approve pending workflow runs
      deny        Deny pending workflow runs
      archive     Mark terminal runs as archived (reviewed, no further action needed). Archived runs are hidden from default listings
      unarchive   Restore archived runs to their prior terminal status
      model       List and test LLM models
      mcp         Model Context Protocol server
      server      Server operations
      doctor      Check environment and integration health
      version     Show client and server version information
      install     Set up the Fabro environment (LLMs, certs, GitHub)
      uninstall   Uninstall Fabro from this machine
      auth        Manage CLI authentication state
      pr          Pull request operations
      parent      Manage run parent links
      secret      Manage server-owned secrets
      variable    Manage server-owned variables
      settings    Inspect effective settings
      workflow    Workflow operations
      discord     Open the Discord community in the browser
      docs        Open the docs website in the browser
      upgrade     Upgrade fabro to the latest version
      repo        Repository commands
      provider    Provider operations
      sandbox     Sandbox operations (cp, ssh, preview)
      completion  Generate shell completions
      system      System maintenance commands
      help        Print this message or the help of the given subcommand(s)

    Options:
          --json              Output as JSON [env: FABRO_JSON=]
          --debug             Enable DEBUG-level logging (default is INFO) [env: FABRO_DEBUG=]
          --no-upgrade-check  Disable automatic upgrade check [env: FABRO_NO_UPGRADE_CHECK=true]
          --quiet             Suppress non-essential output [env: FABRO_QUIET=]
          --verbose           Enable verbose output [env: FABRO_VERBOSE=]
      -h, --help              Print help
      -V, --version           Print version
    ----- stderr -----
    ");
}

#[test]
fn no_args_prints_curated_landing() {
    let context = test_context!();
    let cmd = context.command();
    fabro_snapshot!(context.filters(), cmd, @r"
    success: true
    exit_code: 0
    ----- stdout -----
    fabro — AI-powered workflow orchestration.

    Usage: fabro <command>

    Set up

      fabro install        Set up the Fabro environment (LLMs, certs, GitHub)
      fabro doctor         Check environment and integration health
      fabro repo init      Initialize Fabro in a repository
      fabro server start   Start the Fabro API server
      fabro secret set     Store a server-owned secret
      fabro docs           Open the docs website in the browser

    Run workflows

      fabro validate       Validate a workflow
      fabro preflight      Validate run configuration without executing
      fabro run            Launch a workflow run

    Inspect runs

      fabro events         View the event log of a workflow run
      fabro logs           View the raw worker tracing log of a workflow run
      fabro sandbox ssh    SSH into a run's sandbox

    If you need help along the way:

      Run fabro <command> --help for more information about a command.
      Join our Discord at https://fabro.sh/discord to get help from the Fabro community.

    For a full list of commands, run `fabro help`.
    ----- stderr -----
    ");
}

#[test]
fn llm_namespace_is_not_available() {
    let context = test_context!();
    let mut cmd = context.command();
    cmd.arg("llm");
    fabro_snapshot!(context.filters(), cmd, @"
    success: false
    exit_code: 2
    ----- stdout -----
    ----- stderr -----
    error: unrecognized subcommand 'llm'

    Usage: fabro [OPTIONS] [COMMAND]

    For more information, try '--help'.
    ");
}