Merge pull request #8 from YOU54F/feat/extensions

feat: add pactflow-ai / pact-ruby-standalone via extensions framework

Author: YOU54F

Cargo.lock

@@ -25,6 +25,10 @@ include = [
 clap = { version = "4.5.2", features = ["derive", "env", "cargo"] }
 clap_complete = { version = "4.5.1", features = [] }
 home = "0.5.5"
+reqwest = { version = "0.12.24", features = ["json"] }
+serde = { version = "1.0.228", features = ["derive"] }
+serde_json = "1.0.145"
+comfy-table = "7.2.1"
 
 # pact-stub-server = { version = "*", path = "/Users/saf/dev/pact-foundation/pact-stub-server"}
 # pact_mock_server_cli = { version = "2.0.0-beta.1", path = "/Users/saf/dev/pact-foundation/pact-core-mock-server/pact_mock_server_cli"}

Cargo.toml

@@ -0,0 +1,220 @@
+# Pact CLI Extensions
+
+The Pact CLI supports an extension system that allows you to install and manage additional tools and legacy binaries. Extensions integrate with the main CLI, providing access to functionality like AI-powered contract testing and legacy Pact Ruby based tools.
+
+## 🚀 Quick Start
+
+```bash
+# List available extensions
+pact extension list
+
+# Install PactFlow AI extension
+pact extension install pactflow-ai
+
+# Install Ruby legacy tools
+pact extension install pact-ruby-standalone
+
+# Use PactFlow AI directly
+pact pactflow ai --help
+
+# Use legacy tools
+pact extension pact-broker-legacy --help
+```
+
+## 📦 Available Extensions
+
+### PactFlow AI
+
+**AI-augmented contract testing tools**
+
+- **Name**: `pactflow-ai`
+- **Type**: PactFlow AI
+- **Usage**: `pact pactflow ai <args>` or `pact extension pactflow-ai <args>`
+- **Features**: AI-augmented contract generation, reviews
+- **Platforms**: macOS (Intel/Apple Silicon), Linux (x64/ARM64), Windows (x64/ARM64)
+
+### Ruby Legacy Tools
+
+**Traditional Ruby-based Pact tools (pact-ruby-standalone)**
+
+- **Name**: `pact-ruby-standalone`
+- **Type**: Ruby Legacy
+- **Includes**:
+  - `pact-broker-legacy` - Legacy Pact Broker client
+  - `pactflow-legacy` - Legacy PactFlow client
+  - `message-legacy` - Legacy message pact tools
+  - `mock-legacy` - Legacy mock service
+  - `verifier-legacy` - Legacy provider verifier
+  - `stub-legacy` - Legacy stub service
+- **Usage**: `pact extension <tool-name> <args>`
+- **Platforms**: macOS, Linux, Windows
+
+## 🛠 Extension Management
+
+### Installation
+
+```bash
+# Install latest version
+pact extension install pactflow-ai
+pact extension install pact-ruby-standalone
+
+# Install specific version
+pact extension install pactflow-ai --version 1.11.4
+pact extension install pact-ruby-standalone --version v2.5.5
+```
+
+### Listing Extensions
+
+```bash
+# List all extensions
+pact extension list
+
+# Show only installed extensions
+pact extension list --installed
+```
+
+Output example:
+
+```
+📦 Available extensions:
+Name                 Type       Installed       Latest          Status    
+---------------------------------------------------------------------------
+pactflow-ai          PactFlow AI 1.11.4         1.11.4          ✅ Installed
+pact-broker-legacy   Ruby Legacy v2.5.5         v2.5.5          ✅ Installed
+pactflow-legacy      Ruby Legacy v2.5.5         v2.5.5          ✅ Installed
+message-legacy       Ruby Legacy v2.5.5         v2.5.5          ✅ Installed
+mock-legacy          Ruby Legacy v2.5.5         v2.5.5          ✅ Installed
+verifier-legacy      Ruby Legacy v2.5.5         v2.5.5          ✅ Installed
+stub-legacy          Ruby Legacy v2.5.5         v2.5.5          ✅ Installed
+```
+
+### Updating Extensions
+
+```bash
+# Update all installed extensions
+pact extension update --all
+
+# Update specific extension
+pact extension update pactflow-ai
+pact extension update pact-ruby-standalone
+```
+
+### Uninstalling Extensions
+
+```bash
+# Uninstall PactFlow AI
+pact extension uninstall pactflow-ai
+
+# Uninstall Ruby legacy tools (removes all legacy tools)
+pact extension uninstall pact-ruby-standalone
+
+# Uninstall individual legacy tool
+pact extension uninstall pact-broker-legacy
+```
+
+## 🔧 Usage Patterns
+
+### PactFlow AI Integration
+
+The PactFlow AI extension integrates seamlessly with the `pactflow` command:
+
+```bash
+# These are equivalent:
+pact pactflow ai --help
+pact extension pactflow-ai --help
+```
+
+### Legacy Ruby Tools
+
+Legacy tools are accessed via the extension system:
+
+```bash
+# Legacy Pact Broker operations
+pact extension pact-broker-legacy can-i-deploy --pacticipant my-app --version 1.0.0
+
+# Legacy provider verification
+pact extension verifier-legacy
+
+# Legacy mock service
+pact extension mock-legacy
+```
+
+## 📁 Extension Storage
+
+Extensions are installed to `~/.pact/extensions/` by default:
+
+```
+~/.pact/extensions/
+├── config.json                    # Extension configuration
+├── bin/                           # Symlinks to extension binaries
+│   ├── pactflow-ai
+│   ├── pact-broker-legacy
+│   ├── pactflow-legacy
+│   ├── message-legacy
+│   ├── mock-legacy
+│   ├── verifier-legacy
+│   └── stub-legacy
+└── pact-ruby-standalone/               # Ruby tools installation
+    └── bin/
+        ├── pact-broker
+        ├── pactflow
+        ├── pact-message
+        ├── pact-mock-service
+        ├── pact-provider-verifier
+        └── pact-stub-service
+```
+
+### Custom Installation Directory
+
+You can customize the extension directory using the `PACT_CLI_EXTENSIONS_HOME` environment variable:
+
+```bash
+export PACT_CLI_EXTENSIONS_HOME=/opt/pact-extensions
+pact extension install pactflow-ai
+```
+
+## 🔍 Version Management
+
+The extension system provides intelligent version tracking:
+
+### PactFlow AI Versions
+
+- **Installed Version**: Retrieved by executing `pactflow-ai --version`
+- **Latest Version**: Fetched from `https://download.pactflow.io/ai/dist/{platform}/latest`
+- **Manual Updates**: Use `pact extension update pactflow-ai`
+
+### Ruby Legacy Versions
+
+- **Installed Version**: Recorded during installation from GitHub release tag
+- **Latest Version**: Fetched from GitHub API `/repos/pact-foundation/pact-standalone/releases/latest`
+- **Manual Updates**: Use `pact extension update pact-ruby-standalone`
+
+## 🌍 Platform Support
+
+### PactFlow AI
+
+- **macOS**: Intel (x86_64) and Apple Silicon (aarch64)
+- **Linux**: x86_64 and aarch64
+- **Windows**: x86_64 and aarch64
+
+### Ruby Legacy Tools
+
+- **macOS**: Intel (x86_64) and Apple Silicon (aarch64)
+- **Linux**: x86_64 and aarch64
+- **Windows**: x86_64 only
+
+## 🔗 Integration Examples
+
+### GitHub Actions
+
+```yaml
+# GitHub Actions example
+- uses: you54f/pact-cli@main
+- name: Install Pact Extensions
+  run: |
+    pact extension install pactflow-ai
+    pact extension install pact-ruby-standalone
+- name: Or Install All Pact Extensions
+  run: |
+    pact extension install --all
+```

EXTENSIONS.md

@@ -123,14 +123,41 @@ tags format
 
 ```console
 $ pact --help
-Pact consolidated CLI - pact_core_mock_server, pact_verifier, pact-stub-server, pact-plugin-cli, pact-broker-cli in a single binary
+
+**Pact** is the de-facto API contract testing tool. Replace expensive and brittle end-to-end integration tests with fast, reliable and easy to debug unit tests.
+
+Check out https://docs.pact.io
+
+- ⚡ Lightning fast
+- 🎈 Effortless full-stack integration testing - from the front-end to the back-end
+- 🔌 Supports HTTP/REST and event-driven systems
+- 🛠️  Configurable mock server
+- 😌 Powerful matching rules prevents brittle tests
+- 🤝 Integrates with Pact Broker / PactFlow for powerful CI/CD workflows
+- 🔡 Supports 12+ languages
+
+**Why use Pact?**
+
+Contract testing with Pact lets you:
+
+- ⚡ Test locally
+- 🚀 Deploy faster
+- ⬇️  Reduce the lead time for change
+- 💰 Reduce the cost of API integration testing
+- 💥 Prevent breaking changes
+- 🔎 Understand your system usage
+- 📃 Document your APIs for free
+- 🗄  Remove the need for complex data fixtures
+- 🤷 Reduce the reliance on complex test environments
+        
 
 Usage: pact [OPTIONS] [COMMAND]
 
 Commands:
   broker       A Rust and CLI client for the Pact Broker. Publish and retrieve pacts and verification results.
   pactflow     PactFlow specific commands
   completions  Generates completion scripts for your shell
+  extension    Manage Pact CLI extensions
   plugin       CLI utility for Pact plugins
   mock         Standalone Pact mock server
   verifier     Standalone pact verifier for provider pact verification
@@ -140,20 +167,38 @@ Commands:
 Options:
       --enable-otel
           Enable OpenTelemetry tracing
+
       --enable-otel-logs
           Enable OpenTelemetry logging
+
       --enable-otel-traces
           Enable OpenTelemetry traces
+
       --otel-exporter <otel-exporter>
-          The OpenTelemetry exporter(s) to use, comma separated (stdout, otlp) [env: OTEL_TRACES_EXPORTER=]
+          The OpenTelemetry exporter(s) to use, comma separated (stdout, otlp)
+          
+          [env: OTEL_TRACES_EXPORTER=]
+
       --otel-exporter-endpoint <otel-exporter-endpoint>
-          The endpoint to use for the OTLP exporter (required if --otel-exporter=otlp) [env: OTEL_EXPORTER_OTLP_ENDPOINT=]
+          The endpoint to use for the OTLP exporter (required if --otel-exporter=otlp)
+          
+          [env: OTEL_EXPORTER_OTLP_ENDPOINT=]
+
       --otel-exporter-protocol <otel-exporter-protocol>
-          The protocol to use for the OTLP exporter (http/protobuf, http) [env: OTEL_EXPORTER_OTLP_PROTOCOL=] [default: http] [possible values: http, http/protobuf]
+          The protocol to use for the OTLP exporter (http/protobuf, http)
+          
+          [env: OTEL_EXPORTER_OTLP_PROTOCOL=]
+          [default: http]
+          [possible values: http, http/protobuf]
+
       --log-level <LEVEL>
-          Set the log level (none, off, error, warn, info, debug, trace) [default: off] [possible values: off, none, error, warn, info, debug, trace]
+          Set the log level (none, off, error, warn, info, debug, trace)
+          
+          [default: off]
+          [possible values: off, none, error, warn, info, debug, trace]
+
   -h, --help
-          Print help
+          Print help (see a summary with '-h')
 
 ```