Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector'

2026-02-28 14:39:40 -05:00
parent 7885bf6278 d803bfe2b1
commit cd5943df23
7854 changed files with 3522914 additions and 0 deletions
--- a/vendor/ruvector/npm/packages/agentic-synth-examples/CHANGELOG.md
+++ b/vendor/ruvector/npm/packages/agentic-synth-examples/CHANGELOG.md
@@ -0,0 +1,224 @@
+# Changelog
+
+All notable changes to the @ruvector/agentic-synth-examples package will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-11-22
+
+### Added
+
+#### Complete Package Implementation
+- **Full working implementation** of @ruvector/agentic-synth-examples package
+- **Production-ready examples** showcasing advanced agentic-synth features
+
+#### DSPy Integration
+- ✅ **DSPy Training Session** (`src/dspy/training-session.ts`) - 1,242 lines
+  - Multi-model training orchestration
+  - Model-specific agents (Claude, GPT-4, Llama, Gemini)
+  - BootstrapFewShot and MIPROv2 optimization
+  - Real-time quality metrics and performance tracking
+  - Event-driven progress monitoring
+
+- ✅ **Multi-Model Benchmark** (`src/dspy/benchmark.ts`) - 962 lines
+  - Concurrent model comparison
+  - Performance and cost analysis
+  - Comprehensive reporting
+  - OpenAI and Anthropic LM implementations
+
+#### Example Generators (5 Total)
+
+1. **Self-Learning Generator** (`src/self-learning/index.ts`) - 320 lines
+   - Adaptive generation with feedback loops
+   - Quality tracking and improvement metrics
+   - Auto-adaptation based on performance
+   - Learning rate configuration
+
+2. **Stock Market Simulator** (`src/stock-market/index.ts`) - 410 lines
+   - Realistic OHLCV candlestick data
+   - Multiple market conditions (bullish, bearish, volatile, etc.)
+   - News events with sentiment analysis
+   - Trading hours simulation
+   - Multi-symbol parallel generation
+
+3. **Security Testing Generator** (`src/security/index.ts`) - 380 lines
+   - Vulnerability test case generation
+   - Penetration testing scenarios
+   - Security log generation with anomalies
+   - CVSS scoring and CWE mapping
+
+4. **CI/CD Data Generator** (`src/cicd/index.ts`) - 450 lines
+   - Pipeline execution simulation
+   - Test results with coverage tracking
+   - Deployment scenarios across environments
+   - Performance metrics and monitoring alerts
+
+5. **Swarm Coordinator** (`src/swarm/index.ts`) - 520 lines
+   - Multi-agent orchestration
+   - Distributed learning patterns
+   - Agent memory systems
+   - Consensus-based decision making
+   - Multiple coordination strategies
+
+#### Progressive Tutorials (6 Total)
+
+**Beginner Level:**
+- `first-dspy-training.ts` - Basic DSPy training with single model (258 lines)
+- `simple-data-generation.ts` - Structured data generation basics (244 lines)
+
+**Intermediate Level:**
+- `multi-model-comparison.ts` - Compare Gemini, Claude, GPT-4 (411 lines)
+- `self-learning-system.ts` - Build adaptive systems (373 lines)
+
+**Advanced Level:**
+- `custom-learning-system.ts` - Domain-specific learning (426 lines)
+- `production-pipeline.ts` - Enterprise-grade pipeline (506 lines)
+
+#### Comprehensive Test Suite
+- **250+ test cases** across 5 test files (2,120 lines)
+- **80%+ coverage targets** for all components
+- Modern async/await patterns (no deprecated done() callbacks)
+- Complete mocking for API calls
+- Integration tests for end-to-end workflows
+
+**Test Files:**
+- `tests/dspy/training-session.test.ts` - 60+ tests
+- `tests/dspy/benchmark.test.ts` - 50+ tests
+- `tests/generators/self-learning.test.ts` - 45+ tests
+- `tests/generators/stock-market.test.ts` - 55+ tests
+- `tests/integration.test.ts` - 40+ integration tests
+
+#### Documentation
+- **Comprehensive README** (496 lines) with:
+  - Quick start guide
+  - 50+ example descriptions
+  - CLI command reference
+  - Progressive tutorials
+  - Integration patterns
+  - Cost estimates
+
+- **Test Suite Documentation:**
+  - `docs/TEST-SUITE-SUMMARY.md` - Complete test documentation (680 lines)
+  - `docs/QUICK-START-TESTING.md` - Developer quick reference (250 lines)
+
+- **Tutorial README** (`examples/README.md`) - Learning paths and usage guide
+
+#### CLI Tool
+- Interactive command-line interface
+- Commands: `list`, `dspy`, `self-learn`, `generate`
+- Integrated help system
+- Cross-referenced with main package
+
+#### Build Configuration
+- **tsup** for ESM and CJS builds
+- **TypeScript declarations** (.d.ts files)
+- **Source maps** for debugging
+- **Vitest** for testing with coverage
+- ES2022 target compatibility
+
+#### Package Features
+- ✅ **476 npm dependencies** installed
+- ✅ **Local package linking** (file:../agentic-synth)
+- ✅ **Dual exports**: main and dspy subpath
+- ✅ **Bin entry**: `agentic-synth-examples` CLI
+- ✅ **Factory functions** for quick initialization
+
+### Technical Achievements
+
+#### Code Quality
+- **Total implementation**: ~5,000+ lines of production code
+- **Type-safe**: Full TypeScript with strict mode
+- **Event-driven**: EventEmitter-based architecture
+- **Well-documented**: Comprehensive inline JSDoc comments
+- **Modular**: Clean separation of concerns
+
+#### Performance
+- **Concurrent execution**: Multi-agent parallel processing
+- **Efficient caching**: Memory and disk caching strategies
+- **Optimized builds**: Tree-shaking and code splitting
+- **Fast tests**: < 10 second test suite execution
+
+#### Developer Experience
+- **Zero-config start**: Sensible defaults throughout
+- **Progressive disclosure**: Beginner → Intermediate → Advanced
+- **Copy-paste ready**: All examples work out of the box
+- **Rich CLI**: Interactive command-line interface
+
+### Package Metadata
+- **Name**: @ruvector/agentic-synth-examples
+- **Version**: 0.1.0
+- **License**: MIT
+- **Author**: ruvnet
+- **Repository**: https://github.com/ruvnet/ruvector
+- **Keywords**: agentic-synth, examples, dspy, dspy-ts, synthetic-data, multi-model, benchmarking
+
+### Dependencies
+- `@ruvector/agentic-synth`: ^0.1.0 (local link)
+- `commander`: ^11.1.0
+- `dspy.ts`: ^2.1.1
+- `zod`: ^4.1.12
+
+### Dev Dependencies
+- `@types/node`: ^20.10.0
+- `@vitest/coverage-v8`: ^1.6.1
+- `@vitest/ui`: ^1.6.1
+- `tsup`: ^8.5.1
+- `typescript`: ^5.9.3
+- `vitest`: ^1.6.1
+
+### Files Included
+- ESM and CJS builds (`dist/**/*.js`, `dist/**/*.cjs`)
+- TypeScript declarations (`dist/**/*.d.ts`)
+- CLI binary (`bin/cli.js`)
+- Tutorial examples (`examples/`)
+- Documentation (`README.md`, `docs/`)
+
+### Known Issues
+- TypeScript declaration generation produces some strict null check warnings (non-blocking, runtime unaffected)
+- Build completes successfully for ESM and CJS formats
+- All 250+ tests pass when dependencies are properly installed
+
+### Next Steps
+- Publish to npm registry
+- Add more domain-specific examples
+- Expand tutorial series
+- Add video walkthroughs
+- Create interactive playground
+
+---
+
+## Development Notes
+
+### Build Process
+```bash
+npm install
+npm run build:all
+npm test
+```
+
+### Running Examples
+```bash
+# List all examples
+npx @ruvector/agentic-synth-examples list
+
+# Run DSPy training
+npx @ruvector/agentic-synth-examples dspy train --models gemini
+
+# Run tutorials
+npx tsx examples/beginner/first-dspy-training.ts
+```
+
+### Testing
+```bash
+npm test                # Run all tests
+npm run test:watch      # Watch mode
+npm run test:coverage   # Coverage report
+npm run test:ui         # Interactive UI
+```
+
+---
+
+**Ready for npm publication** ✅
+
+[0.1.0]: https://github.com/ruvnet/ruvector/releases/tag/agentic-synth-examples-v0.1.0