cli-validation

What problem does it solve?

Provides a structured, evidence-first workflow to verify that command-line tools build or install correctly and behave as expected across help/version output, happy-path execution, error cases, stdin/pipe handling, output formats, and exit codes.

Core Features & Use Cases

• Cross-language build checks: Guidance for building or installing binaries for Rust, Go, Node.js, and Python projects and verifying the produced executable.
• Behavioral validation: Exercises help and version flags, happy-path commands, invalid flags, missing arguments, file-not-found and permission error cases, and stdin/pipe behavior while recording stdout, stderr, and exit codes.
• Output and evidence: Validates structured outputs (JSON/CSV), captures full command output to an evidence directory, and defines pass criteria for automated verification and human review.

Quick Start

Run the project build, locate or install the binary, then execute the primary command while saving stdout, stderr, and exit codes into the e2e-evidence directory.