v0.9.15 - Production Observability 🚀

Major release adding enterprise-grade observability for production deployments with Prometheus metrics, health endpoints, and structured logging.

🚀 What's New

1. Structured Logging

Production-ready JSON logging for log aggregation systems (ELK, Datadog, Splunk):

# JSON format for production
weave --log-format json --log-level info docs ls MyDocs

# Text format for CLI (colored, human-readable)
weave --log-format text --log-level debug docs ls MyDocs

Features:

• JSON format with RFC3339 timestamps
• Structured fields: vdb_type, operation, collection, document_id
• Log levels: debug, info, warn, error
• Helper functions: WithVDB(), WithCollection(), WithDocument()

2. Prometheus Metrics

Full Prometheus integration with 4 core metrics:

# Enable metrics server
weave --metrics docs ls MyDocs

# Custom port
weave --metrics --metrics-port 8080 docs ls MyDocs

# Access metrics
curl http://localhost:9090/metrics

Metrics Available:

1. Request Duration (Histogram)
2. Document Count (Counter)
3. Error Count (Counter)
4. Active Connections (Gauge)

Performance: ~2% overhead when enabled, zero overhead when disabled

3. Health Endpoints

Kubernetes-ready health checks:

# Check endpoints
curl http://localhost:9090/healthz  # Liveness probe
curl http://localhost:9090/readyz   # Readiness probe

Endpoints:

• /healthz: Liveness probe (tolerates partial degradation)
• /readyz: Readiness probe (strict, returns 200 only if ALL DBs healthy)

4. Persistent Metrics Server (NEW!)

Long-running server for production deployments:

# Start persistent server
weave serve

# With custom config
weave serve --metrics-port 8080 --log-format json --log-file /var/log/weave.log

Features:

• Runs until interrupted (Ctrl+C, SIGTERM, SIGINT)
• Graceful shutdown with 10s timeout
• Exposes /metrics, /healthz, /readyz persistently
• Perfect for Docker containers and Kubernetes pods

5. Comprehensive Documentation

New Documentation:

• OBSERVABILITY.md (700+ lines)
• WEAVE_MCP.md (MCP Integration Roadmap)

Updated Documentation:

• USER_GUIDE.md: New observability section
• README.md: Updated with observability features

---

📊 Kubernetes Integration

Complete Kubernetes manifests included for Deployment, Service, and Prometheus ServiceMonitor.

---

📈 Performance Impact

Feature	Overhead	Notes
Structured Logging (JSON)	~5%	vs text format
Prometheus Metrics	~2%	when enabled
Health Endpoints	<1ms	per check
Overall	<5%	recommended for production

---

🆙 Upgrading from v0.9.12

Breaking Changes: None - fully backward compatible!

All observability features are opt-in and disabled by default.

---

🚀 Get Started

```bash

Clone and build

git clone https://github.com/maximilien/weave-cli.git
cd weave-cli
git checkout v0.9.15
./build.sh

Verify version

./bin/weave --version

Try observability features

./bin/weave --log-format json --metrics docs ls MyDocs

Start production server

./bin/weave serve --metrics-port 9090
```

---

Full Release Notes: See docs/releases/RELEASE_v0.9.15.md

Weave-cli v0.9.15 - Production Ready! 🎉

Release v0.9.13.1

Weave CLI v0.9.13.1

Changes since v0.9.13

• docs: move IMAGE_EXTRACTION_FIX.md to docs directory
• release: prepare v0.9.13.1 with CMYK image extraction fix
• fix: implement pdfimages fallback for CMYK PDF image extraction
• style: fix markdown linting issues in release notes
• docs: add comprehensive v0.9.13 release notes

Downloads

• Linux AMD64: weave-linux-amd64
• Linux ARM64: weave-linux-arm64
• macOS AMD64: weave-darwin-amd64
• macOS ARM64: weave-darwin-arm64
• Windows AMD64: weave-windows-amd64.exe

Installation

Download the appropriate binary for your platform and make it executable:

# Linux/macOS
chmod +x weave-linux-amd64
mv weave-linux-amd64 /usr/local/bin/weave
weave --help

# Windows
weave-windows-amd64.exe --help

Verification

Verify the integrity of the downloaded binary:

sha256sum -c checksums.txt

Release v0.9.13

Weave CLI v0.9.13

Changes since v0.9.12

• release: prepare v0.9.13 changelog
• docs: update weekend prep with critical fix details
• fix: remove -t shortcut for --timeout to resolve flag conflict
• docs: add weekend prep summary for January 29-31 work plan
• test: fix Qdrant adapter test to handle missing server gracefully
• style: fix markdown linting issues in README.md
• feat: add weave vdb command for vector database management
• feat: add -t shortcut for --timeout flag and enhance documentation
• docs: add comprehensive timeout configuration guide
• feat: add config validation and error context for Qdrant, Milvus, Chroma
• docs: complete VDB lifecycle management implementation plan

Downloads

• Linux AMD64: weave-linux-amd64
• Linux ARM64: weave-linux-arm64
• macOS AMD64: weave-darwin-amd64
• macOS ARM64: weave-darwin-arm64
• Windows AMD64: weave-windows-amd64.exe

Installation

Download the appropriate binary for your platform and make it executable:

# Linux/macOS
chmod +x weave-linux-amd64
mv weave-linux-amd64 /usr/local/bin/weave
weave --help

# Windows
weave-windows-amd64.exe --help

Verification

Verify the integrity of the downloaded binary:

sha256sum -c checksums.txt

Release v0.9.12

Weave CLI v0.9.12

Changes since v0.9.11

• docs: update README with v0.9.12 production hardening features
• docs: prepare release v0.9.12 - production hardening complete
• feat: add rich error context to Weaviate VDB operations
• test: add comprehensive unit tests for logging package
• feat: add structured logging with file output and config support
• feat: add agent validation with typo suggestions and comprehensive error messages

Downloads

• Linux AMD64: weave-linux-amd64
• Linux ARM64: weave-linux-arm64
• macOS AMD64: weave-darwin-amd64
• macOS ARM64: weave-darwin-arm64
• Windows AMD64: weave-windows-amd64.exe

Installation

Download the appropriate binary for your platform and make it executable:

# Linux/macOS
chmod +x weave-linux-amd64
mv weave-linux-amd64 /usr/local/bin/weave
weave --help

# Windows
weave-windows-amd64.exe --help

Verification

Verify the integrity of the downloaded binary:

sha256sum -c checksums.txt

Release v0.9.11

Weave CLI v0.9.11

Changes since v0.9.10

• feat: release v0.9.11 - multi-agent orchestration + search tests
• feat: boost Supabase test coverage from 13.0% to 21.3%
• feat: boost Neo4j test coverage from 3.9% to 15.8%
• fix: sort evaluation results by timestamp (newest first)
• docs: update README with custom evaluator output example
• feat: integrate custom evaluators into evaluation runner
• style: add YAML document start markers to evaluator files

Downloads

• Linux AMD64: weave-linux-amd64
• Linux ARM64: weave-linux-arm64
• macOS AMD64: weave-darwin-amd64
• macOS ARM64: weave-darwin-arm64
• Windows AMD64: weave-windows-amd64.exe

Installation

Download the appropriate binary for your platform and make it executable:

# Linux/macOS
chmod +x weave-linux-amd64
mv weave-linux-amd64 /usr/local/bin/weave
weave --help

# Windows
weave-windows-amd64.exe --help

Verification

Verify the integrity of the downloaded binary:

sha256sum -c checksums.txt

Release v0.9.10

Weave CLI v0.9.10

Changes since v0.9.9

• docs: prepare release 0.9.10 - custom evaluators and opik integration
• feat: complete custom evaluators system with CLI commands
• style: apply linter formatting to custom_evaluator.go
• docs: fix markdown linting issues in custom evaluators README
• feat: implement custom evaluator system - Phase 1 complete
• feat: complete Opik integration with hybrid approach (Option A)
• docs: update planning documents with test coverage and Opik integration plan
• test: increase evaluation package coverage from 60.5% to 66.4%
• docs: fix markdown linting issues in README
• test: add comprehensive provider tests and update README
• feat: add pluggable evaluator architecture with optional Opik integration
• feat: implement Phase 2 - Advanced Evaluators & Benchmarking
• docs: update NEXT_ACTIONS.md for v0.9.9 and future phases
• chore: move debug script to tools/dev and clean up coverage files

Downloads

• Linux AMD64: weave-linux-amd64
• Linux ARM64: weave-linux-arm64
• macOS AMD64: weave-darwin-amd64
• macOS ARM64: weave-darwin-arm64
• Windows AMD64: weave-windows-amd64.exe

Installation

Download the appropriate binary for your platform and make it executable:

# Linux/macOS
chmod +x weave-linux-amd64
mv weave-linux-amd64 /usr/local/bin/weave
weave --help

# Windows
weave-windows-amd64.exe --help

Verification

Verify the integrity of the downloaded binary:

sha256sum -c checksums.txt

Release v0.9.9

Weave CLI v0.9.9

Changes since v0.9.7

• test: add comprehensive integration tests for evaluation system
• fix: linting issues with datasets YAML
• refactor: simplify database flags in help output
• feat: add dataset creation tools and example datasets
• feat: implement Phase 1 - Agent Evaluation System
• docs: add comprehensive agent management documentation
• test: add comprehensive unit and integration tests for agent management
• feat: add smart defaults and self-contained agent templates
• feat: enhance 'weave config show' to display agent locations
• feat: add agent management commands (Phase 0)
• docs: extend evaluation proposal with full RAG pipeline support
• docs: add comprehensive agent evaluation system proposal
• docs: add comprehensive test coverage tracking (v0.9.7.1)
• test: add factory tests for pkg/vectordb/pinecone (10.2% coverage)
• test: add tests for pkg/vectordb/mock adapter (24.1% coverage)
• test: add comprehensive tests for pkg/llm (49.3% coverage)
• test: add comprehensive tests for pkg/mock (73.8% coverage)
• style: apply linter formatting to test files
• test: add comprehensive tests for pkg/config helpers (26.4% coverage)
• test: add comprehensive tests for pkg/image (31.9% coverage)
• test: add comprehensive tests for cmd/utils helpers and errors
• test: add comprehensive tests for pkg/progress reporter (91.8% coverage)
• test: add comprehensive tests for pkg/output formatter (96.5% coverage)
• test: add unit tests for pkg/version and Milvus v0.9.7-v0.9.8 fixes
• test: TRAE test audit
• docs: add v0.9.8 release notes to CHANGELOG.md
• fix: handle VARCHAR and JSONBytes types in Milvus ListDocuments (v0.9.8)
• docs: create user consultation guide
• docs: create comprehensive v1.0 roadmap for AuctionsMax.ai consultation
• docs: update NEXT_ACTIONS.md for v0.9.7 release and next steps
• fix: resolve all markdown linting warnings in CHANGELOG.md
• fix: update references to moved documentation files
• chore: fix markdown linting and organize documentation

Downloads

• Linux AMD64: weave-linux-amd64
• Linux ARM64: weave-linux-arm64
• macOS AMD64: weave-darwin-amd64
• macOS ARM64: weave-darwin-arm64
• Windows AMD64: weave-windows-amd64.exe

Installation

Download the appropriate binary for your platform and make it executable:

# Linux/macOS
chmod +x weave-linux-amd64
mv weave-linux-amd64 /usr/local/bin/weave
weave --help

# Windows
weave-windows-amd64.exe --help

Verification

Verify the integrity of the downloaded binary:

sha256sum -c checksums.txt

Release v0.9.7.1

Weave CLI v0.9.7.1

Changes since v0.9.7

• docs: add comprehensive test coverage tracking (v0.9.7.1)
• test: add factory tests for pkg/vectordb/pinecone (10.2% coverage)
• test: add tests for pkg/vectordb/mock adapter (24.1% coverage)
• test: add comprehensive tests for pkg/llm (49.3% coverage)
• test: add comprehensive tests for pkg/mock (73.8% coverage)
• style: apply linter formatting to test files
• test: add comprehensive tests for pkg/config helpers (26.4% coverage)
• test: add comprehensive tests for pkg/image (31.9% coverage)
• test: add comprehensive tests for cmd/utils helpers and errors
• test: add comprehensive tests for pkg/progress reporter (91.8% coverage)
• test: add comprehensive tests for pkg/output formatter (96.5% coverage)
• test: add unit tests for pkg/version and Milvus v0.9.7-v0.9.8 fixes
• test: TRAE test audit
• docs: add v0.9.8 release notes to CHANGELOG.md
• fix: handle VARCHAR and JSONBytes types in Milvus ListDocuments (v0.9.8)
• docs: create user consultation guide
• docs: create comprehensive v1.0 roadmap for AuctionsMax.ai consultation
• docs: update NEXT_ACTIONS.md for v0.9.7 release and next steps
• fix: resolve all markdown linting warnings in CHANGELOG.md
• fix: update references to moved documentation files
• chore: fix markdown linting and organize documentation

Downloads

• Linux AMD64: weave-linux-amd64
• Linux ARM64: weave-linux-arm64
• macOS AMD64: weave-darwin-amd64
• macOS ARM64: weave-darwin-arm64
• Windows AMD64: weave-windows-amd64.exe

Installation

Download the appropriate binary for your platform and make it executable:

# Linux/macOS
chmod +x weave-linux-amd64
mv weave-linux-amd64 /usr/local/bin/weave
weave --help

# Windows
weave-windows-amd64.exe --help

Verification

Verify the integrity of the downloaded binary:

sha256sum -c checksums.txt

Release v0.9.8

Weave CLI v0.9.8

Changes since v0.9.7

• docs: add v0.9.8 release notes to CHANGELOG.md
• fix: handle VARCHAR and JSONBytes types in Milvus ListDocuments (v0.9.8)
• docs: create user consultation guide
• docs: create comprehensive v1.0 roadmap for AuctionsMax.ai consultation
• docs: update NEXT_ACTIONS.md for v0.9.7 release and next steps
• fix: resolve all markdown linting warnings in CHANGELOG.md
• fix: update references to moved documentation files
• chore: fix markdown linting and organize documentation

Downloads

• Linux AMD64: weave-linux-amd64
• Linux ARM64: weave-linux-arm64
• macOS AMD64: weave-darwin-amd64
• macOS ARM64: weave-darwin-arm64
• Windows AMD64: weave-windows-amd64.exe

Installation

Download the appropriate binary for your platform and make it executable:

# Linux/macOS
chmod +x weave-linux-amd64
mv weave-linux-amd64 /usr/local/bin/weave
weave --help

# Windows
weave-windows-amd64.exe --help

Verification

Verify the integrity of the downloaded binary:

sha256sum -c checksums.txt

Release v0.9.7

Weave CLI v0.9.7

Changes since v0.9.6

• chore: prepare release v0.9.7
• fix: CRITICAL - truncate Image VARCHAR field for Milvus compatibility (v0.9.7)
• debug: add logging for image metadata field lengths

Downloads

• Linux AMD64: weave-linux-amd64
• Linux ARM64: weave-linux-arm64
• macOS AMD64: weave-darwin-amd64
• macOS ARM64: weave-darwin-arm64
• Windows AMD64: weave-windows-amd64.exe

Installation

Download the appropriate binary for your platform and make it executable:

# Linux/macOS
chmod +x weave-linux-amd64
mv weave-linux-amd64 /usr/local/bin/weave
weave --help

# Windows
weave-windows-amd64.exe --help

Verification

Verify the integrity of the downloaded binary:

sha256sum -c checksums.txt