feat: add module workflow tools (validate, inspect, package)

[joshrotenberg]

Summary

This PR adds three new commands to support Redis Enterprise 8.x custom module development workflows:

1. module validate - Validate module.json

Validates module metadata against the RE8 schema before packaging or upload.

# Basic validation
redisctl enterprise module validate ./module.json

# Output:
# Validating: ./module.json
#
#   v module_name: jmespath
#   v version: 300
#   v semantic_version: 0.3.0
#   v min_redis_version: 7.0.0
#   v compatible_redis_version: 8.0.0
#   v commands: 2 commands defined
#   v capabilities: 4 capabilities
#
# v Module metadata is valid for Redis Enterprise 8.x

# Strict mode (requires all recommended fields)
redisctl enterprise module validate ./module.json --strict

Features:

• Checks required fields (module_name)
• Warns about recommended fields (version, semantic_version, min_redis_version)
• Highlights missing compatible_redis_version (required for RE8 upgrade tests)
• Strict mode requires all recommended fields
• JSON output format supported (-o json)

2. module inspect - Inspect packaged modules

Inspects a module zip package to verify structure and contents.

# Basic inspection
redisctl enterprise module inspect ./redis-jmespath.Linux-x86_64.0.3.0.zip

# Output:
# Package: redis-jmespath.Linux-x86_64.0.3.0.zip
#
# Files:
#   module.json (729 bytes)
#   jmespath.so (6.5 MB)
#
# Metadata:
#   Name: jmespath
#   Display: JMESPath
#   Version: 0.3.0 (300)
#   Min Redis: 7.0.0
#   Compatible: 8.0.0
#   Commands: 33
#   Capabilities: types, replica_of, clustering, backup_restore
#
# v Package structure is valid for RE8 user_defined_modules

# Show all commands
redisctl enterprise module inspect ./module.zip --full

Features:

• Shows package contents with file sizes
• Parses and displays module.json metadata
• Validates RE8-compatible structure (flat zip, files at root)
• Full mode shows all command definitions with arity, key positions, flags
• Detects common packaging errors

3. module package - Create RE8-compatible zip

Packages a module binary and metadata into an RE8-compatible zip file.

redisctl enterprise module package \
  --module ./libredis_jmespath.so \
  --metadata ./module.json \
  --out ./dist/redis-jmespath.Linux-x86_64.0.3.0.zip

# With validation before packaging
redisctl enterprise module package \
  --module ./module.so \
  --metadata ./module.json \
  --out ./package.zip \
  --validate

Features:

• Creates flat zip structure (files at root, no subdirectories)
• Optional metadata validation before packaging (--validate)
• Uses deflate compression
• Proper structure for user_defined_modules bootstrap

Why These Tools?

Redis Enterprise 8.x uses a new native module packaging format:

• Old way (RAMP): Required Python, git, ramp-packer, manifest.yml
• New way (RE8): Simple zip with module.json + module.so at root

These tools help catch errors early:

• Missing compatible_redis_version (causes RE8 upgrade test failures)
• Subdirectories in zip (causes "module.json missing" errors)
• Invalid JSON in module.json
• Missing required fields

Testing

• All existing tests pass
• Manually tested all three commands with various inputs
• Tested error cases (missing files, invalid JSON, strict mode failures)

Files Changed

• crates/redisctl/src/commands/enterprise/module.rs - Added command definitions
• crates/redisctl/src/commands/enterprise/module_impl.rs - Added implementations
• crates/redisctl/Cargo.toml - Added zip dependency