🚀 PinViz v0.3.0

⚠️ Breaking Changes

CLI Command Structure Updated

The CLI now requires an explicit render command for diagram generation:

# ❌ Old (no longer works)
pinviz diagram.yaml -o output.svg

# ✅ New
pinviz render diagram.yaml -o output.svg

Why this change?

• Improved clarity and consistency with modern CLI tools (AWS CLI, kubectl, docker, etc.)
• Better command structure for future extensibility
• Clearer help output and user experience

Migration Guide:
Simply add render before your config file path in any scripts or commands.

✨ Improvements

Professional CLI Help Output

The help system has been completely redesigned for better readability:

Before:

Usage: pinviz [-h] [-v] {render,example,list} ...

Examples: # Generate diagram from YAML config pinviz diagram.yaml # Specify 
output path pinviz diagram.yaml -o output/wiring.svg ...

After:

Usage: pinviz [-h] [-v] COMMAND ...

Commands:
  COMMAND
    render       Render a diagram from a configuration file
    example      Generate a built-in example diagram
    list         List available board and device templates

Examples:
  pinviz render diagram.yaml                     # Generate diagram
  pinviz render diagram.yaml -o out/wiring.svg   # Specify output path
  pinviz example bh1750                          # Use built-in example
  pinviz list                                     # List templates

Enhanced CLI Features

• ✅ Removed confusing {render,example,list} syntax from help
• ✅ Examples section now displays properly with line breaks
• ✅ Default values shown for all options (--gpio/--no-gpio)
• ✅ Mutually exclusive option groups
• ✅ Better parameter naming (CONFIG_FILE, PATH, NAME)
• ✅ Custom help formatter preserves formatting
• ✅ Improved command descriptions

🐛 Fixes

• Fixed CLI help examples wrapping into single line
• Updated MCP server documentation with correct commands
• Synchronized all documentation with new CLI format

📚 Documentation Updates

• Updated docs/guide/cli.md with new command syntax
• Updated MCP server docstrings
• All examples now use pinviz render format

🧪 Testing

• ✅ 23/23 CLI tests passing
• ✅ 5/5 MCP tests passing
• ✅ All code validated with ruff
• ✅ No functionality changes beyond command structure

📦 Installation

# CLI tool (recommended)
uv tool install pinviz

# Or with pip
pip install pinviz==0.3.0

Full Changelog: v0.2.2...v0.3.0