aidevops 2.52.1

package/.agent/tools/context/context7.md

@@ -0,0 +1,371 @@
+---
+description: Real-time library documentation via Context7 MCP
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: false
+  glob: true
+  grep: true
+  webfetch: true
+  task: true
+---
+
+# Context7 MCP Setup Guide
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Purpose**: Real-time access to latest library/framework documentation
+- **Command**: `npx -y @context7/mcp-server@latest`
+- **Built into Augment**: No setup needed, tools available directly
+
+**MCP Tools**:
+- `resolve-library-id("next.js")` → Returns "/vercel/next.js"
+- `get-library-docs("/vercel/next.js")` → Returns documentation
+- `get-library-docs("/vercel/next.js", topic="routing")` → Topic-specific
+- `get-library-docs("/vercel/next.js", tokens=15000)` → More detail
+
+**Common Library IDs**:
+- Frontend: `/vercel/next.js`, `/facebook/react`, `/vuejs/vue`
+- Backend: `/expressjs/express`, `/nestjs/nest`
+- DB/ORM: `/prisma/prisma`, `/supabase/supabase`, `/drizzle-team/drizzle-orm`
+- Tools: `/vitejs/vite`, `/typescript-eslint/typescript-eslint`
+
+**Config Location**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+<!-- AI-CONTEXT-END -->
+
+Context7 MCP provides AI assistants with real-time access to the latest documentation for thousands of development tools, frameworks, and libraries.
+
+## 🎯 **What is Context7 MCP?**
+
+Context7 MCP is a Model Context Protocol server that gives AI assistants access to:
+
+- **Latest documentation** for popular development tools and frameworks
+- **Version-specific** documentation and guides
+- **AI-optimized** content format for better understanding
+- **Real-time updates** as libraries and tools evolve
+- **Comprehensive coverage** of the development ecosystem
+
+## 🚀 **Benefits for AI-Assisted Development**
+
+### **Before Context7 MCP:**
+
+- AI assistants work with **outdated training data**
+- **Guessing** at API changes and new features
+- **Inconsistent** information across different versions
+- **Limited** knowledge of recent tools and updates
+
+### **After Context7 MCP:**
+
+- **Real-time access** to latest documentation
+- **Version-specific** guidance and examples
+- **Accurate** API references and best practices
+- **Comprehensive** coverage of your development stack
+
+## 📦 **Installation & Setup**
+
+### **Prerequisites:**
+
+- **Node.js 18+** installed
+- **npm or npx** available
+- **AI assistant** that supports MCP (Claude Desktop, Cursor, etc.)
+
+### **1. Test Context7 MCP Server:**
+
+```bash
+# Test the server (no installation needed with npx)
+npx -y @context7/mcp-server@latest --help
+
+# This should show the Context7 MCP server help
+```
+
+### **2. Add to Your AI Assistant Configuration:**
+
+#### **For Claude Desktop:**
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@context7/mcp-server@latest"],
+      "env": {
+        "DEBUG": "false"
+      }
+    }
+  }
+}
+```
+
+#### **For Cursor IDE:**
+
+Create/edit `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@context7/mcp-server@latest"]
+    }
+  }
+}
+```
+
+#### **For Augment Agent:**
+
+Context7 tools are **built-in** - no additional setup required!
+
+- Use `resolve-library-id` tool to find library IDs
+- Use `get-library-docs` tool to fetch documentation
+
+### **3. Framework Configuration:**
+
+```bash
+# Copy the Context7 MCP configuration template
+cp configs/context7-mcp-config.json.txt configs/context7-mcp-config.json
+
+# Edit with your commonly used libraries and preferences
+```
+
+## 🔧 **Usage Examples**
+
+### **1. Library Resolution:**
+
+```bash
+# Always resolve library names first
+resolve-library-id("next.js")
+# Returns: "/vercel/next.js"
+
+resolve-library-id("react")
+# Returns: "/facebook/react"
+
+resolve-library-id("supabase")
+# Returns: "/supabase/supabase"
+```
+
+### **2. Getting Documentation:**
+
+```bash
+# Get general documentation
+get-library-docs("/vercel/next.js")
+
+# Get topic-specific documentation
+get-library-docs("/vercel/next.js", topic="routing")
+
+# Get version-specific documentation
+get-library-docs("/vercel/next.js/v14.3.0-canary.87")
+
+# Adjust token limits for more/less detail
+get-library-docs("/facebook/react", tokens=10000)
+```
+
+### **3. Common Development Workflows:**
+
+#### **Starting a New Project:**
+
+```bash
+# Get setup documentation for your stack
+resolve-library-id("next.js") -> get-library-docs("/vercel/next.js", topic="getting-started")
+resolve-library-id("tailwind") -> get-library-docs("/tailwindlabs/tailwindcss", topic="installation")
+resolve-library-id("prisma") -> get-library-docs("/prisma/prisma", topic="setup")
+```
+
+#### **Debugging Issues:**
+
+```bash
+# Get troubleshooting guides
+get-library-docs("/vercel/next.js", topic="troubleshooting")
+
+# Check API changes between versions
+get-library-docs("/facebook/react/v18.2.0")
+get-library-docs("/facebook/react/v18.3.0")
+```
+
+#### **Learning New Tools:**
+
+```bash
+# Comprehensive documentation for new library
+resolve-library-id("drizzle-orm") -> get-library-docs("/drizzle-team/drizzle-orm")
+
+# Get examples and best practices
+get-library-docs("/drizzle-team/drizzle-orm", topic="examples")
+```
+
+## 📚 **Common Library Categories**
+
+### **Frontend Frameworks:**
+
+- `/vercel/next.js` - Next.js React framework
+- `/facebook/react` - React library
+- `/vuejs/vue` - Vue.js framework
+- `/angular/angular` - Angular framework
+- `/sveltejs/svelte` - Svelte framework
+
+### **Backend Frameworks:**
+
+- `/expressjs/express` - Express.js for Node.js
+- `/nestjs/nest` - NestJS framework
+- `/fastify/fastify` - Fastify web framework
+- `/django/django` - Django Python framework
+- `/flask/flask` - Flask Python framework
+
+### **Databases & ORMs:**
+
+- `/mongodb/docs` - MongoDB database
+- `/postgres/postgres` - PostgreSQL database
+- `/supabase/supabase` - Supabase platform
+- `/prisma/prisma` - Prisma ORM
+- `/drizzle-team/drizzle-orm` - Drizzle ORM
+
+### **Development Tools:**
+
+- `/microsoft/vscode` - VS Code editor
+- `/typescript-eslint/typescript-eslint` - TypeScript ESLint
+- `/prettier/prettier` - Code formatter
+- `/vitejs/vite` - Vite build tool
+- `/webpack/webpack` - Webpack bundler
+
+### **AI/ML Tools:**
+
+- `/openai/openai-node` - OpenAI Node.js SDK
+- `/anthropic/anthropic-sdk-typescript` - Anthropic TypeScript SDK
+- `/langchain-ai/langchainjs` - LangChain JavaScript
+- `/huggingface/transformers.js` - Hugging Face Transformers
+
+## 🛠️ **Best Practices**
+
+### **Library Resolution:**
+
+1. **Always resolve first**: Use `resolve-library-id` before `get-library-docs`
+2. **Use specific names**: "next.js" is better than "nextjs"
+3. **Check alternatives**: Some libraries have multiple valid IDs
+4. **Cache results**: Store resolved IDs for repeated use
+
+### **Documentation Retrieval:**
+
+1. **Use topics**: Specify topics for focused results (`topic="routing"`)
+2. **Manage tokens**: Adjust token limits based on detail needed
+3. **Version-specific**: Use specific versions when working with older code
+4. **Combine sources**: Get docs from multiple related libraries
+
+### **Development Workflow:**
+
+1. **Start with docs**: Get documentation before coding
+2. **Reference during development**: Keep docs accessible while coding
+3. **Check for updates**: Regularly verify you're using latest practices
+4. **Validate approaches**: Use docs to verify your implementation approach
+
+## 🔍 **Troubleshooting**
+
+### **Common Issues:**
+
+#### **Library Not Found:**
+
+```bash
+# Try different variations
+resolve-library-id("nextjs")      # Try without dots
+resolve-library-id("next")        # Try shortened name
+resolve-library-id("vercel/next") # Try with org prefix
+```
+
+#### **Documentation Seems Outdated:**
+
+```bash
+# Check for specific version
+get-library-docs("/vercel/next.js/v14.0.0")
+
+# Verify library has moved or been renamed
+resolve-library-id("new-library-name")
+```
+
+#### **MCP Server Not Responding:**
+
+```bash
+# Test the server directly
+npx -y @context7/mcp-server@latest --version
+
+# Check your AI assistant's MCP configuration
+# Restart your AI assistant
+```
+
+## 🎯 **Integration with Your Workflow**
+
+### **Project Setup:**
+
+```bash
+# Create project-specific library list
+echo '["next.js", "tailwind", "prisma", "supabase"]' > .context7-libraries
+
+# Get setup docs for all libraries
+for lib in $(cat .context7-libraries); do
+  resolve-library-id("$lib") && get-library-docs(result, topic="setup")
+done
+```
+
+### **Code Review:**
+
+- **Verify best practices** against latest documentation
+- **Check for deprecated** APIs and patterns
+- **Reference migration guides** for version updates
+- **Validate security practices** with official guidelines
+
+### **Learning & Development:**
+
+- **Explore new libraries** with comprehensive documentation
+- **Understand breaking changes** between versions
+- **Learn best practices** from official examples
+- **Stay updated** with latest features and improvements
+
+## 🌟 **Advanced Features**
+
+### **Version-Specific Documentation:**
+
+```bash
+# Get docs for specific version
+get-library-docs("/vercel/next.js/v13.5.0")
+
+# Compare between versions
+get-library-docs("/react-router/react-router/v5.3.0")
+get-library-docs("/react-router/react-router/v6.0.0")
+```
+
+### **Topic-Focused Queries:**
+
+```bash
+# Get specific topic documentation
+get-library-docs("/vercel/next.js", topic="api-routes")
+get-library-docs("/prisma/prisma", topic="migrations")
+get-library-docs("/supabase/supabase", topic="authentication")
+```
+
+### **Token Management:**
+
+```bash
+# Brief overview (default: 5000 tokens)
+get-library-docs("/facebook/react")
+
+# Detailed documentation (more tokens)
+get-library-docs("/facebook/react", tokens=15000)
+
+# Quick reference (fewer tokens)
+get-library-docs("/facebook/react", tokens=2000)
+```
+
+## 📈 **Benefits for Your Development**
+
+✅ **Always Current** - Documentation is continuously updated
+✅ **Version Aware** - Access docs for specific versions you're using
+✅ **AI Optimized** - Content formatted for better AI understanding
+✅ **Comprehensive** - Covers thousands of popular development tools
+✅ **Fast Access** - Real-time retrieval without manual searching
+✅ **Context Aware** - AI understands your specific development context
+
+---
+
+**Transform your AI-assisted development with real-time access to the latest documentation!** 🚀📚

package/.agent/tools/context/dspy.md

@@ -0,0 +1,302 @@
+---
+description: DSPy framework for programmatic LLM optimization
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: true
+  glob: true
+  grep: true
+  webfetch: true
+  task: true
+---
+
+# DSPy Integration Guide
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- DSPy: Framework for algorithmically optimizing LLM prompts and weights
+- Requires: Python 3.8+, OpenAI/Anthropic API key
+- Helper: `./.agent/scripts/dspy-helper.sh install|test|init [project]`
+- Config: `configs/dspy-config.json` (copy from .txt template)
+- Projects: `data/dspy/[project-name]/`
+- Virtual env: `python-env/dspy-env/`
+- Key classes: Signature (define I/O), Module (logic), ChainOfThought (reasoning)
+- Optimizers: BootstrapFewShot (few-shot), COPRO (iterative), MIPRO (multi-stage)
+- API keys: Uses env vars `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`
+<!-- AI-CONTEXT-END -->
+
+## Overview
+
+DSPy (Declarative Self-improving Python) is a framework for algorithmically optimizing LM prompts and weights. This integration provides seamless access to DSPy's powerful prompt optimization capabilities within the AI DevOps Framework.
+
+## 🚀 **Quick Start**
+
+### **Prerequisites**
+
+- Python 3.8+ installed
+- Virtual environment support
+- OpenAI API key (or other LLM provider)
+
+### **Installation**
+
+```bash
+# Install DSPy dependencies
+./.agent/scripts/dspy-helper.sh install
+
+# Test installation
+./.agent/scripts/dspy-helper.sh test
+```
+
+### **Configuration**
+
+1. **Copy configuration template:**
+
+   ```bash
+   cp configs/dspy-config.json.txt configs/dspy-config.json
+   ```
+
+2. **Edit configuration:**
+
+   ```bash
+   # Add your API keys and customize settings
+   nano configs/dspy-config.json
+   ```
+
+3. **Set environment variables (if not already set):**
+
+   ```bash
+   # DSPy automatically uses your terminal session's API keys
+   export OPENAI_API_KEY="your-api-key-here"
+   export ANTHROPIC_API_KEY="your-anthropic-key-here"
+
+   # Check current environment
+   echo $OPENAI_API_KEY
+   ```
+
+   **Note**: DSPy prioritizes environment variables over config file values, so your existing terminal session API keys will be used automatically!
+
+## 📁 **Project Structure**
+
+```text
+aidevops/
+├── .agent/scripts/dspy-helper.sh          # DSPy management script
+├── configs/dspy-config.json          # DSPy configuration
+├── python-env/dspy-env/              # Python virtual environment
+├── data/dspy/                        # DSPy projects and datasets
+├── logs/                             # DSPy logs
+└── requirements.txt                  # Python dependencies
+```
+
+## 🛠️ **Usage**
+
+### **Initialize New Project**
+
+```bash
+# Create a new DSPy project
+./.agent/scripts/dspy-helper.sh init my-chatbot
+
+# Navigate to project directory
+cd data/dspy/my-chatbot
+```
+
+### **Basic DSPy Example**
+
+```python
+import dspy
+import os
+
+# Configure DSPy with OpenAI
+lm = dspy.OpenAI(model="gpt-3.5-turbo", api_key=os.getenv("OPENAI_API_KEY"))
+dspy.settings.configure(lm=lm)
+
+# Define a signature
+class BasicQA(dspy.Signature):
+    """Answer questions with helpful, accurate responses."""
+    question = dspy.InputField()
+    answer = dspy.OutputField(desc="A helpful and accurate answer")
+
+# Create a module
+class QAModule(dspy.Module):
+    def **init**(self):
+        super().**init**()
+        self.generate_answer = dspy.ChainOfThought(BasicQA)
+
+    def forward(self, question):
+        return self.generate_answer(question=question)
+
+# Use the module
+qa = QAModule()
+result = qa(question="What is DSPy?")
+print(result.answer)
+```
+
+### **Optimization Example**
+
+```python
+import dspy
+from dspy.teleprompt import BootstrapFewShot
+
+# Define training data
+trainset = [
+    dspy.Example(question="What is AI?", answer="Artificial Intelligence..."),
+    dspy.Example(question="How does ML work?", answer="Machine Learning..."),
+    # Add more examples
+]
+
+# Create and compile optimizer
+teleprompter = BootstrapFewShot(metric=dspy.evaluate.answer_exact_match)
+compiled_qa = teleprompter.compile(QAModule(), trainset=trainset)
+
+# Use optimized module
+result = compiled_qa(question="Explain neural networks")
+```
+
+## 🔧 **Configuration Options**
+
+### **Language Models**
+
+```json
+{
+  "language_models": {
+    "providers": {
+      "openai": {
+        "api_key": "YOUR_OPENAI_API_KEY",
+        "models": {
+          "gpt-4": "gpt-4",
+          "gpt-3.5-turbo": "gpt-3.5-turbo"
+        }
+      },
+      "anthropic": {
+        "api_key": "YOUR_ANTHROPIC_API_KEY",
+        "models": {
+          "claude-3-sonnet": "claude-3-sonnet-20240229"
+        }
+      }
+    }
+  }
+}
+```
+
+### **Optimization Settings**
+
+```json
+{
+  "optimization": {
+    "optimizers": {
+      "BootstrapFewShot": {
+        "max_bootstrapped_demos": 4,
+        "max_labeled_demos": 16
+      },
+      "COPRO": {
+        "metric": "accuracy",
+        "breadth": 10,
+        "depth": 3
+      }
+    }
+  }
+}
+```
+
+## 📊 **Available Optimizers**
+
+### **BootstrapFewShot**
+
+- **Purpose**: Automatically generate few-shot examples
+- **Best for**: General prompt optimization
+- **Configuration**: `max_bootstrapped_demos`, `max_labeled_demos`
+
+### **COPRO (Coordinate Ascent)**
+
+- **Purpose**: Iterative prompt optimization
+- **Best for**: Complex reasoning tasks
+- **Configuration**: `metric`, `breadth`, `depth`
+
+### **MIPRO (Multi-Prompt Optimization)**
+
+- **Purpose**: Multi-stage prompt optimization
+- **Best for**: Multi-step reasoning
+- **Configuration**: `metric`, `num_candidates`
+
+## 🎯 **Best Practices**
+
+### **1. Start Simple**
+
+```python
+# Begin with basic signatures
+class SimpleQA(dspy.Signature):
+    question = dspy.InputField()
+    answer = dspy.OutputField()
+```
+
+### **2. Use Quality Training Data**
+
+```python
+# Provide diverse, high-quality examples
+trainset = [
+    dspy.Example(question="...", answer="...").with_inputs('question'),
+    # More examples with clear input/output patterns
+]
+```
+
+### **3. Choose Appropriate Metrics**
+
+```python
+# Define custom metrics for your use case
+def custom_metric(example, pred, trace=None):
+    return example.answer.lower() in pred.answer.lower()
+```
+
+### **4. Iterate and Refine**
+
+```python
+# Test different optimizers and configurations
+optimizers = [
+    BootstrapFewShot(metric=custom_metric),
+    COPRO(metric=custom_metric, breadth=5),
+]
+```
+
+## 🔍 **Troubleshooting**
+
+### **Common Issues**
+
+1. **Import Errors**
+
+   ```bash
+   # Ensure virtual environment is activated
+   source python-env/dspy-env/bin/activate
+   ```
+
+2. **API Key Issues**
+
+   ```bash
+   # Check environment variables
+   echo $OPENAI_API_KEY
+   ```
+
+3. **Memory Issues**
+
+   ```python
+   # Reduce batch sizes for large datasets
+   dspy.settings.configure(lm=lm, max_tokens=1000)
+   ```
+
+## 📚 **Additional Resources**
+
+- [DSPy Documentation](https://dspy-docs.vercel.app/)
+- [DSPy GitHub Repository](https://github.com/stanfordnlp/dspy)
+- [DSPy Paper](https://arxiv.org/abs/2310.03714)
+- [AI DevOps Framework Documentation](../README.md)
+
+## 🤝 **Integration with AI DevOps**
+
+DSPy integrates seamlessly with other AI DevOps Framework components:
+
+- **Agno Integration**: Use DSPy-optimized prompts in Agno agents
+- **Quality Control**: Optimize prompts for better code quality analysis
+- **Documentation**: Generate optimized prompts for documentation tasks
+- **Server Management**: Create optimized prompts for infrastructure tasks