Feature: CLI Version, Info, and Diagnostics Commands Showcase Documentation
  As a CleverAgents user
  I want to understand the version, info, and diagnostics commands
  So that I can verify my installation and troubleshoot issues

  Scenario: Verify showcase documentation exists
    Given the showcase documentation file exists at "docs/showcase/cli-tools/cli-version-info-diagnostics.md"
    When I read the documentation file
    Then the documentation should contain "Understanding CleverAgents CLI Version, Info, and Diagnostics Commands"
    And the documentation should contain the "version" command explanation
    And the documentation should contain the "info" command explanation
    And the documentation should contain the "diagnostics" command explanation
    And the documentation should contain the "Fast-Path vs Regular Command Behavior" section
    And the documentation should contain JSON output examples
    And the documentation should contain YAML output examples

  Scenario: Verify showcase is registered in examples.json
    Given the showcase examples registry exists at "docs/showcase/examples.json"
    When I read the examples registry
    Then the registry should contain an entry for "Understanding CleverAgents CLI Version, Info, and Diagnostics Commands"
    And the registry entry should have category "cli-tools"
    And the registry entry should have path "cli-tools/cli-version-info-diagnostics.md"
    And the registry entry should list version, info, and diagnostics commands
    And the registry entry should have complexity "beginner"
    And the registry entry should have educational_value "high"
