git clone https://github.com/VecTrade-io/vectrade-sdk-generator.git
cd vectrade-sdk-generator
pip install -e ".[dev]"

# Validate all SDK contracts against the OpenAPI spec
vectrade-sdk-gen validate

# Validate a specific SDK
vectrade-sdk-gen validate --sdk python
vectrade-sdk-gen validate --sdk node

# Show endpoint coverage across all SDKs
vectrade-sdk-gen coverage

# Output as JSON
vectrade-sdk-gen coverage --format json

# Compare SDK implementations for parity
vectrade-sdk-gen align --spec ../vectrade-openapi/spec.yaml \
  --python ../vectrade-python \
  --node ../vectrade-node

# tests/contract/quotes.yaml
resource: quotes
endpoints:
  - operation: getQuote
    method: GET
    path: /vq/quotes/{symbol}
    params:
      symbol: { type: string, required: true }
    response:
      type: object
      properties: [symbol, price, change, change_pct, volume, timestamp]

  - operation: batchQuotes
    method: GET
    path: /vq/quotes/batch
    params:
      tickers: { type: string, required: true }
    response:
      type: array

# .github/workflows/ci.yml
- name: Contract validation
  run: |
    pip install vectrade-sdk-generator
    vectrade-sdk-gen validate --spec spec.yaml --sdk .

vectrade-sdk-generator/
├── src/vectrade_sdk_generator/
│   ├── cli.py           # CLI entry point
│   ├── contracts.py     # Contract YAML loader
│   ├── coverage.py      # Coverage analyzer
│   ├── reporter.py      # Report generation
│   └── validator.py     # Alignment validator
└── tests/contract/      # 15 YAML contract definitions