docs(showcase): showcase CLI version/info/diagnostics commands

This commit is contained in:
2026-04-22 06:53:42 +00:00
committed by Forgejo
parent 34f658a32a
commit e8425449b2
@@ -1,81 +1,8 @@
Feature: CLI Version, Info, and Diagnostics Commands Showcase
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
Background:
Given the CleverAgents CLI is installed and available
Scenario: Display version information using fast-path execution
When I run the command "agents version"
Then the output should contain "CleverAgents"
And the output should contain a version number
And the command should complete quickly (within 200ms)
Scenario: Display version information in JSON format
When I run the command "agents --format json version"
Then the output should be valid JSON
And the JSON should have a "status" field with value "success"
And the JSON should have a "data" field containing version information
And the JSON data should contain "version" field
And the JSON data should contain "python_version" field
Scenario: Display version information in YAML format
When I run the command "agents --format yaml version"
Then the output should be valid YAML
And the YAML should have a "status" field with value "success"
And the YAML should have a "data" field containing version information
Scenario: Display comprehensive system information
When I run the command "agents info"
Then the output should contain "CleverAgents System Information"
And the output should contain "Version Information"
And the output should contain "Installation Details"
And the output should contain "System Configuration"
And the output should contain "Feature Flags"
Scenario: Display system information in JSON format
When I run the command "agents --format json info"
Then the output should be valid JSON
And the JSON should have a "status" field with value "success"
And the JSON data should contain "version" field
And the JSON data should contain "installation" field
And the JSON data should contain "configuration" field
And the JSON data should contain "features" field
Scenario: Run system diagnostics
When I run the command "agents diagnostics"
Then the output should contain "CleverAgents System Diagnostics Report"
And the output should contain "Installation Check"
And the output should contain "Configuration Check"
And the output should contain "Database Check"
And the output should contain "Summary"
And the output should contain "Status"
Scenario: Run diagnostics in JSON format
When I run the command "agents --format json diagnostics"
Then the output should be valid JSON
And the JSON should have a "status" field with value "success"
And the JSON data should contain "timestamp" field
And the JSON data should contain "system" field
And the JSON data should contain "checks" field
And the JSON data should contain "summary" field
Scenario: Verify fast-path vs regular command behavior
When I run the command "agents version"
Then the command should complete quickly (within 200ms)
When I run the command "agents info"
Then the command should take longer than version command
When I run the command "agents diagnostics"
Then the command should take longer than version command
Scenario: Verify output format consistency
When I run the command "agents --format json version"
And I run the command "agents --format json info"
And I run the command "agents --format json diagnostics"
Then all JSON outputs should have a "status" field
And all JSON outputs should have a "data" field
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