docs: use JMESPath extensions for remaining jq conversions

Leverage redisctl's extended JMESPath functions to convert additional
jq examples that require advanced features:

- group_by() for grouping arrays by field value
- divide()/multiply() for arithmetic operations
- sprintf() for formatted string output
- has() for key existence checks
- join() for array-to-string conversion

Remaining jq usage is limited to:
- @csv output formatting (no JMESPath equivalent)
- Pretty-printing raw JSON (jq .)

Author: joshrotenberg

docs/src/cookbook/enterprise/node-management.md

@@ -149,15 +149,16 @@ redisctl enterprise node get --node-id 1 -o json -q '{
 echo "Node Health Report"
 echo "==================" 
 
-# Using jq for complex string formatting
-redisctl enterprise node list -o json | jq -r '
-  .[] | 
-  "Node \(.uid): \(.status) - CPU: \(.cpu_idle)% idle, " +
-  "Memory: \((.used_memory / .total_memory * 100 | floor))% used, " +
-  "Shards: \(.shard_count)"
-'
-
-# Alternative: Use JMESPath for structured output
+# Using JMESPath sprintf() for formatted string output
+redisctl enterprise node list -q '
+  [].sprintf(
+    `"Node %s: %s - CPU: %.0f%% idle, Memory: %.0f%% used, Shards: %d"`,
+    uid, status, cpu_idle,
+    multiply(divide(used_memory, total_memory), `100`),
+    shard_count
+  )' --raw
+
+# Alternative: Use JMESPath for structured table output
 redisctl enterprise node list -q '[].{node: uid, status: status, cpu_idle: cpu_idle, shards: shard_count}' -o table
 ```
 

docs/src/enterprise/advanced/jsonschema.md

@@ -182,17 +182,17 @@ echo "$PAYLOAD" | jq --argjson schema "$SCHEMA" '
 Convert to OpenAPI specification:
 
 ```bash
-# Extract and format for OpenAPI
-redisctl enterprise jsonschema get -o json | jq '{
-  openapi: "3.0.0",
+# Extract and format for OpenAPI using JMESPath
+redisctl enterprise jsonschema get -q '{
+  openapi: `"3.0.0"`,
   info: {
-    title: "Redis Enterprise API",
-    version: .version
+    title: `"Redis Enterprise API"`,
+    version: version
   },
   components: {
-    schemas: .definitions
+    schemas: definitions
   },
-  paths: .paths
+  paths: paths
 }' > openapi.json
 ```
 
@@ -244,14 +244,14 @@ curl -k -u "$REDIS_ENTERPRISE_USER:$REDIS_ENTERPRISE_PASSWORD" \
 Validate that the schema is well-formed:
 
 ```bash
-# Check if valid JSON (using jq for JSON validation)
-redisctl enterprise jsonschema get | jq empty && echo "Valid JSON"
+# Check if valid JSON - redisctl will error if invalid
+redisctl enterprise jsonschema get -q 'length(@)' > /dev/null && echo "Valid JSON"
 
-# Validate schema structure (jq for boolean expressions)
-redisctl enterprise jsonschema get | jq 'has("definitions") and has("$schema")'
+# Validate schema structure using JMESPath has() function
+redisctl enterprise jsonschema get -q 'has(@, `"definitions"`) && has(@, `"$schema"`)'
 
-# Check for required sections
-redisctl enterprise jsonschema get -q '[has("definitions"), has("properties"), has("paths")] | all'
+# Check for required sections using has() function
+redisctl enterprise jsonschema get -q '[has(@, `"definitions"`), has(@, `"properties"`), has(@, `"paths"`)] | all_expr(@, &@)'
 ```
 
 ## Related Commands

docs/src/enterprise/monitoring/usage-report.md

@@ -204,15 +204,16 @@ for team in team-a team-b team-c; do
     -o table
 done
 
-# Calculate team memory usage
-redisctl enterprise usage-report get -q 'databases[].{
-  team: split(name, `-`)[0],
-  memory_mb: memory_mb
-}' | jq -s 'group_by(.team) | map({
-  team: .[0].team,
-  total_memory_mb: map(.memory_mb) | add,
-  database_count: length
-})'
+# Calculate team memory usage using JMESPath extensions
+# group_by and sum are available as extended functions
+redisctl enterprise usage-report get -q '
+  group_by(databases[].{team: split(name, `-`)[0], memory_mb: memory_mb}, `"team"`)
+  | items(@)
+  | [*].{
+      team: [0],
+      total_memory_mb: sum([1][].memory_mb),
+      database_count: length([1])
+    }'
 ```
 
 ## Export Formats
@@ -256,15 +257,16 @@ gdrive upload /tmp/usage.csv
 Send usage metrics to monitoring systems:
 
 ```bash
-# Prometheus metrics format
-redisctl enterprise usage-report get -o json | jq -r '
-  "redis_cluster_databases \(.usage.total_databases)",
-  "redis_cluster_shards \(.usage.total_shards)",
-  "redis_cluster_memory_gb \(.usage.total_memory_gb)",
-  "redis_cluster_nodes \(.usage.total_nodes)",
-  "redis_license_shards_limit \(.license.shards_limit)",
-  "redis_license_memory_limit_gb \(.license.memory_limit_gb)"
-' | curl -X POST http://pushgateway:9091/metrics/job/redis-usage --data-binary @-
+# Prometheus metrics format using JMESPath sprintf()
+redisctl enterprise usage-report get -q '
+  join(`"\n"`, [
+    sprintf(`"redis_cluster_databases %d"`, usage.total_databases),
+    sprintf(`"redis_cluster_shards %d"`, usage.total_shards),
+    sprintf(`"redis_cluster_memory_gb %.2f"`, usage.total_memory_gb),
+    sprintf(`"redis_cluster_nodes %d"`, usage.total_nodes),
+    sprintf(`"redis_license_shards_limit %d"`, license.shards_limit),
+    sprintf(`"redis_license_memory_limit_gb %.2f"`, license.memory_limit_gb)
+  ])' --raw | curl -X POST http://pushgateway:9091/metrics/job/redis-usage --data-binary @-
 
 # Datadog metrics
 redisctl enterprise usage-report get -o json | \
@@ -288,9 +290,11 @@ Create tickets for capacity warnings:
 #!/bin/bash
 # Check usage and create tickets
 
-USAGE=$(redisctl enterprise usage-report get -o json)
-SHARD_PCT=$(echo $USAGE | jq '.usage.total_shards / .license.shards_limit * 100')
-MEMORY_PCT=$(echo $USAGE | jq '.usage.total_memory_gb / .license.memory_limit_gb * 100')
+# Use JMESPath divide() and multiply() for percentage calculations
+SHARD_PCT=$(redisctl enterprise usage-report get \
+  -q 'multiply(divide(usage.total_shards, license.shards_limit), `100`)' --raw)
+MEMORY_PCT=$(redisctl enterprise usage-report get \
+  -q 'multiply(divide(usage.total_memory_gb, license.memory_limit_gb), `100`)' --raw)
 
 if (( $(echo "$SHARD_PCT > 80" | bc -l) )); then
   echo "High shard usage: ${SHARD_PCT}%" | \