docs: comprehensive CLI documentation audit and fixes

README.md

@@ -27,11 +27,11 @@ Once installed, the `capiscio` command is available in your terminal. It passes
 # Validate an agent
 capiscio validate https://my-agent.example.com
 
-# Validate with JSON output (includes scores)
+# Validate with JSON output
 capiscio validate https://my-agent.example.com --json
 
 # Check version
-capiscio version
+capiscio --version
 ```
 
 ### Wrapper Utilities

docs/getting-started/installation.md

@@ -19,7 +19,7 @@ Once installed, the `capiscio` command is available in your terminal. It passes
 capiscio validate ./agent-card.json
 
 # Check version
-capiscio version
+capiscio --version
 ```
 
 For full command reference, see the [CapiscIO Core Documentation](../../capiscio-core/index.md).

docs/index.md

@@ -39,11 +39,11 @@ pip install capiscio
 # Validate an agent card
 capiscio validate ./agent-card.json
 
-# Validate with JSON output (includes scores)
+# Validate with JSON output
 capiscio validate ./agent-card.json --json
 
 # Check core binary version
-capiscio version
+capiscio --version
 ```
 
 ## What This Package Does

docs/reference/commands.md

@@ -39,8 +39,8 @@ capiscio validate ./agent-card.json --json
 capiscio validate https://agent.example.com --test-live
 
 # Check version of the core binary
-capiscio version
+capiscio --version
 
-# Generate a signing key
-capiscio key gen --output ./my-key.jwk
+# Generate a signing key pair
+capiscio key gen --out-priv ./private.jwk --out-pub ./public.jwk
 ```