Add JSON Output to Run Command

[josecelano]

Description

Implements JSON output format for the run command following the Strategy Pattern established in #349, #352, and #355.

Closes #357

Changes

Implementation

• TextView (src/presentation/views/commands/run/text_view.rs): Refactors existing text output logic using shared components (CompactServiceUrlsView and DnsHintView)
• JsonView (src/presentation/views/commands/run/json_view.rs): Serializes ServiceInfo and GrafanaInfo to JSON with environment_name and state wrapper
• RunCommandController: Updated to accept output_format parameter and use Strategy Pattern to select appropriate view
• Router: Updated to pass output_format from ExecutionContext to controller

Testing

• 4 unit tests for TextView (basic output, grafana, DNS hints, tip)
• 4 unit tests for JsonView (basic JSON, grafana, valid parsing, all fields)
• All existing tests updated to pass OutputFormat::Text
• All tests passing ✅
• All linters passing ✅

Documentation

• Added comprehensive JSON output section to docs/user-guide/commands/run.md
• Documented JSON structure with examples for HTTP-only and HTTPS/TLS environments
• Included automation use cases with jq examples
• Documented all JSON fields with descriptions

Architecture

Follows the established pattern from previous implementations:

1. TextView: Renders human-readable output with service URLs and DNS hints
2. JsonView: Renders machine-readable JSON for automation
3. Controller: Uses Strategy Pattern to select view based on output_format
4. Router: Extracts output_format from context and passes to controller

Example Usage

Text Output (default)

torrust-tracker-deployer run my-env

JSON Output

torrust-tracker-deployer run my-env --output-format json
# Or short form:
torrust-tracker-deployer run my-env -o json

JSON with jq

# Extract API endpoint
torrust-tracker-deployer run my-env -o json | jq -r '.services.api_endpoint'

# Check if HTTPS is enabled
torrust-tracker-deployer run my-env -o json | jq -r '.services.api_uses_https'

# Get all HTTP tracker URLs
torrust-tracker-deployer run my-env -o json | jq -r '.services | (.direct_http_trackers + .https_http_trackers)[]'

Verification

• ✅ All unit tests pass
• ✅ All linters pass (markdown, yaml, toml, cspell, clippy, rustfmt, shellcheck)
• ✅ Follows established patterns from Add JSON Output to create Command #349, Add JSON output to provision command #352, Add JSON output to show command #355
• ✅ Documentation updated with examples and automation use cases
• ✅ Backward compatible (text output unchanged)

Related Issues

• Part of EPIC EPIC: Add JSON output format support #348 (Phase 1: JSON Output for High-Value Commands)
• Task 12.4 in project roadmap
• Follows pattern from:
  • Add JSON Output to create Command #349 (create command)
  • Add JSON output to provision command #352 (provision command)
  • Add JSON output to show command #355 (show command)

[josecelano]

ACK 81f925a