aidevops 2.52.1

package/.agent/aidevops/configs.md

@@ -0,0 +1,274 @@
+---
+description: Configuration files AI context
+mode: subagent
+tools:
+  read: true
+  write: true
+  edit: true
+  bash: false
+  glob: true
+  grep: true
+  webfetch: false
+---
+
+# Configuration Files AI Context
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Templates**: `configs/[service]-config.json.txt` (safe to commit)
+- **Working files**: `configs/[service]-config.json` (gitignored, contains credentials)
+- **Setup wizard**: `.agent/scripts/setup-wizard-helper.sh full-setup`
+- **Generate configs**: `.agent/scripts/setup-wizard-helper.sh generate-configs`
+- **Test connections**: `.agent/scripts/setup-wizard-helper.sh test-connections`
+- **Validate JSON**: `jq '.' [service]-config.json`
+- **Secure permissions**: `chmod 600 configs/*-config.json`
+- **Structure**: `{"accounts": {...}, "default_settings": {...}, "mcp_servers": {...}}`
+- **Multi-account**: Support for personal/work/client accounts per service
+<!-- AI-CONTEXT-END -->
+
+This folder contains configuration templates and working configuration files for all services in the AI DevOps Framework.
+
+## File Structure
+
+### Template Files (Committed)
+
+```bash
+# Template files (.txt extension) - safe to commit
+[service]-config.json.txt           # Configuration template
+```
+
+### Working Files (Gitignored)
+
+```bash
+# Working configuration files - contain actual credentials
+[service]-config.json               # Active configuration (NEVER COMMIT)
+setup-wizard-responses.json         # Setup wizard responses (NEVER COMMIT)
+```
+
+## Configuration Categories
+
+### Infrastructure & Hosting
+
+- `hostinger-config.json.txt` - Shared hosting credentials
+- `hetzner-config.json.txt` - Cloud VPS API tokens
+- `closte-config.json.txt` - VPS hosting credentials
+- `cloudron-config.json.txt` - App platform tokens
+
+### Deployment & Orchestration
+
+- `coolify-config.json.txt` - Self-hosted PaaS tokens
+
+### Content Management
+
+- `mainwp-config.json.txt` - WordPress management API tokens
+
+### Security & Secrets
+
+- `vaultwarden-config.json.txt` - Password manager instance configs
+
+### Code Quality & Auditing
+
+- `code-audit-config.json.txt` - Multi-platform auditing service tokens
+
+### Version Control & Git Platforms
+
+- `git-platforms-config.json.txt` - GitHub, GitLab, Gitea tokens
+
+### Email Services
+
+- `ses-config.json.txt` - Amazon SES credentials
+
+### Domain & DNS
+
+- `spaceship-config.json.txt` - Domain registrar API tokens
+- `101domains-config.json.txt` - Domain registrar credentials
+- `cloudflare-dns-config.json.txt` - Cloudflare DNS tokens
+- `namecheap-dns-config.json.txt` - Namecheap DNS credentials
+- `route53-dns-config.json.txt` - AWS Route 53 credentials
+- `other-dns-providers-config.json.txt` - Other DNS providers
+
+### Development & Local
+
+- `localhost-config.json.txt` - Local development settings
+- `mcp-servers-config.json.txt` - MCP server configurations
+- `context7-mcp-config.json.txt` - Context7 MCP settings
+
+## Security Standards
+
+### Template Files (.txt)
+
+- **Safe to commit** - contain no actual credentials
+- **Use placeholder values** like `YOUR_API_TOKEN_HERE`
+- **Include example configurations** for reference
+- **Document all required fields** with comments
+
+### Working Files (.json)
+
+- **NEVER COMMIT** - contain actual credentials
+- **Protected by .gitignore** automatically
+- **Should have restricted permissions** (600 or 640)
+- **Regular backup** to secure location recommended
+
+### Credential Management
+
+```bash
+# Secure file permissions
+chmod 600 configs/*-config.json
+
+# Verify no credentials in git
+git status --porcelain configs/
+
+# Check .gitignore coverage
+git check-ignore configs/*-config.json
+```
+
+## Configuration Structure
+
+### Standard JSON Structure
+
+```json
+{
+  "accounts": {
+    "account-name": {
+      "api_token": "YOUR_TOKEN_HERE",
+      "base_url": "https://api.service.com",
+      "description": "Account description",
+      "username": "your-username"
+    }
+  },
+  "default_settings": {
+    "timeout": 30,
+    "rate_limit": 60,
+    "retry_attempts": 3
+  },
+  "mcp_servers": {
+    "service": {
+      "enabled": true,
+      "port": 3001,
+      "host": "localhost"
+    }
+  }
+}
+```
+
+### Multi-Account Support
+
+Most services support multiple accounts:
+
+```json
+{
+  "accounts": {
+    "personal": { "api_token": "personal_token" },
+    "work": { "api_token": "work_token" },
+    "client": { "api_token": "client_token" }
+  }
+}
+```
+
+## Setup Process
+
+### Initial Configuration
+
+```bash
+# 1. Copy templates to working files
+cp [service]-config.json.txt [service]-config.json
+
+# 2. Edit with actual credentials
+nano [service]-config.json
+
+# 3. Test configuration
+../.agent/scripts/[service]-helper.sh accounts
+
+# 4. Verify security
+chmod 600 [service]-config.json
+```
+
+### Using Setup Wizard
+
+```bash
+# Automated setup with guidance
+../.agent/scripts/setup-wizard-helper.sh full-setup
+
+# Generate all config files from templates
+../.agent/scripts/setup-wizard-helper.sh generate-configs
+
+# Test all connections
+../.agent/scripts/setup-wizard-helper.sh test-connections
+```
+
+## Validation & Testing
+
+### Configuration Validation
+
+```bash
+# Validate JSON syntax
+jq '.' [service]-config.json
+
+# Test service connectivity
+../.agent/scripts/[service]-helper.sh accounts
+
+# Verify API permissions
+../.agent/scripts/[service]-helper.sh help
+```
+
+### Security Validation
+
+```bash
+# Check file permissions
+ls -la *-config.json
+
+# Verify .gitignore protection
+git status --porcelain
+
+# Scan for exposed credentials
+grep -r "token\|password\|secret" . --exclude="*.txt"
+```
+
+## Best Practices
+
+### Configuration Management
+
+1. **Always use templates** as starting point
+2. **Never commit working configs** with credentials
+3. **Use descriptive account names** (personal, work, client)
+4. **Document custom settings** with comments
+5. **Regular credential rotation** for security
+
+### Security Practices
+
+1. **Restrict file permissions** (600 for config files)
+2. **Use separate accounts** for different environments
+3. **Enable MFA** on all service accounts where possible
+4. **Monitor API usage** for unusual activity
+5. **Backup configurations** securely
+
+### Maintenance
+
+1. **Regular updates** of API endpoints and settings
+2. **Credential rotation** every 6-12 months
+3. **Remove unused accounts** and configurations
+4. **Update templates** when services change APIs
+5. **Document changes** in service-specific docs
+
+## AI Assistant Guidelines
+
+### Configuration Handling
+
+- **Never expose credentials** in logs or output
+- **Use configuration validation** before operations
+- **Provide clear setup guidance** for missing configs
+- **Respect account separation** (don't mix personal/work)
+- **Validate permissions** before destructive operations
+
+### Error Handling
+
+- **Clear error messages** for configuration issues
+- **Guidance for fixing** common configuration problems
+- **Security-aware messaging** (don't expose tokens in errors)
+- **Helpful suggestions** for missing or invalid configs
+
+---
+
+**All configuration files are designed for security-first credential management while maintaining ease of use and AI assistant automation capabilities.**

package/.agent/aidevops/docs.md

@@ -0,0 +1,244 @@
+---
+description: Documentation AI context and guidelines
+mode: subagent
+tools:
+  read: true
+  write: true
+  edit: true
+  bash: false
+  glob: true
+  grep: true
+  webfetch: false
+---
+
+# Documentation AI Context
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Location**: All docs in `.agent/*.md` (lowercase filenames)
+- **Service guides**: hostinger.md, hetzner.md, coolify.md, mainwp.md, etc.
+- **Standard structure**: Overview, Configuration, Usage, Security, Troubleshooting, MCP Integration
+- **AI Context blocks**: `<!-- AI-CONTEXT-START -->` sections for quick reference
+- **Cross-service workflows**: Domain -> DNS -> Hosting, Dev -> Quality -> Deploy
+- **Navigation**: Start with service guide, check examples, use troubleshooting
+- **Best practices**: recommendations-opinionated.md for provider selection
+- **Setup guides**: *-setup.md files for complex integrations
+- **Config templates**: `configs/[service]-config.json.txt`
+<!-- AI-CONTEXT-END -->
+
+This folder contains comprehensive documentation for all services and components in the AI DevOps Framework.
+
+## Documentation Categories
+
+### **Service-Specific Guides**
+
+Each service has a comprehensive guide following the standard structure:
+
+**Infrastructure & Hosting:**
+
+- `HOSTINGER.md` - Shared hosting management
+- `HETZNER.md` - Cloud VPS management
+- `CLOSTE.md` - VPS hosting management
+- `CLOUDRON.md` - App platform management
+
+**Deployment & Content:**
+
+- `COOLIFY.md` - Self-hosted PaaS deployment
+- `MAINWP.md` - WordPress management platform
+
+**Security & Quality:**
+
+- `VAULTWARDEN.md` - Password and secrets management
+- `CODE-AUDITING.md` - Multi-platform code quality analysis
+
+**Version Control & Domains:**
+
+- `GIT-PLATFORMS.md` - GitHub, GitLab, Gitea management
+- `DOMAIN-PURCHASING.md` - Automated domain purchasing
+- `SPACESHIP.md` - Spaceship domain registrar
+- `101DOMAINS.md` - 101domains registrar
+
+**Email & DNS:**
+
+- `SES.md` - Amazon SES email delivery
+- `DNS-PROVIDERS.md` - Multi-provider DNS management
+
+**Development & Local:**
+
+- `LOCALHOST.md` - Local development environments
+- `LOCALWP-MCP.md` - LocalWP MCP integration
+- `MCP-SERVERS.md` - MCP server configuration
+- `CONTEXT7-MCP-SETUP.md` - Context7 MCP setup
+
+### **Framework Guides**
+
+- `RECOMMENDATIONS-OPINIONATED.md` - Provider selection and recommendations
+- `CLOUDFLARE-SETUP.md` - Cloudflare API setup guide
+- `COOLIFY-SETUP.md` - Coolify deployment setup
+
+## Standard Documentation Structure
+
+Each service guide follows this consistent format:
+
+```markdown
+# [Service Name] Guide
+
+## 🏢 **Provider Overview**
+### **[Service] Characteristics:**
+- Service type, strengths, API support, use cases
+
+## 🔧 **Configuration**
+- Setup instructions and configuration examples
+
+## 🚀 **Usage Examples**
+- Command examples and common operations
+
+## 🛡️ **Security Best Practices**
+- Security guidelines and recommendations
+
+## 🔍 **Troubleshooting**
+- Common issues and solutions
+
+## 📊 **MCP Integration** (if applicable)
+- MCP server setup and capabilities
+
+## 📚 **Best Practices**
+- Service-specific best practices
+
+## 🎯 **AI Assistant Integration**
+- AI automation capabilities and patterns
+```
+
+## Documentation Standards
+
+### Content Requirements
+
+1. **Complete coverage** of all service features
+2. **Real working examples** with actual commands
+3. **Security considerations** for each service
+4. **Troubleshooting guidance** for common issues
+5. **AI assistant integration** patterns and capabilities
+
+### **Writing Standards**
+
+1. **Clear, concise language** suitable for technical users
+2. **Consistent formatting** across all documents
+3. **Code examples** with proper syntax highlighting
+4. **Visual hierarchy** with appropriate headers and sections
+5. **Cross-references** to related services and guides
+
+### **Technical Standards**
+
+1. **Accurate command syntax** and parameters
+2. **Current API information** and endpoints
+3. **Working configuration examples** (sanitized)
+4. **Proper security guidance** and warnings
+5. **Version-aware information** where applicable
+
+## Documentation Maintenance
+
+### Regular Updates
+
+- **Service API changes** - Update when services change APIs
+- **New features** - Document new service features and capabilities
+- **Security updates** - Update security recommendations
+- **Best practices** - Evolve best practices based on experience
+- **AI capabilities** - Update AI integration patterns
+
+### **Quality Assurance**
+
+- **Technical accuracy** - Verify all commands and examples work
+- **Completeness** - Ensure all service features are documented
+- **Consistency** - Maintain consistent structure and formatting
+- **Clarity** - Ensure documentation is clear and understandable
+- **Currency** - Keep information current and relevant
+
+## AI Assistant Usage Guidelines
+
+### Documentation Navigation
+
+- **Use service-specific guides** for detailed service information
+- **Reference RECOMMENDATIONS-OPINIONATED.md** for provider selection guidance
+- **Check setup guides** for complex integrations
+- **Use Context7 MCP** for latest service documentation when available
+
+### **Information Hierarchy**
+
+1. **Service-specific guides** - Primary source for service details
+2. **Framework context** (`AGENTS.md`) - Overall framework understanding
+3. **Best practices guide** - Provider selection and optimization
+4. **Setup guides** - Complex integration procedures
+5. **Context7 MCP** - Latest external documentation
+
+### **Documentation Patterns**
+
+- **Start with service guide** for comprehensive understanding
+- **Use examples section** for practical implementation
+- **Check troubleshooting** for common issues
+- **Reference security section** for security considerations
+- **Use AI integration section** for automation patterns
+
+## Cross-Service Integration
+
+### Related Services
+
+Many services work together in common workflows:
+
+**Domain → DNS → Hosting:**
+
+- Domain purchasing (Spaceship/101domains)
+- DNS configuration (Cloudflare/Route53)
+- Hosting setup (Hetzner/Hostinger)
+
+**Development → Quality → Deployment:**
+
+- Git platforms (GitHub/GitLab)
+- Code auditing (CodeRabbit/SonarCloud)
+- Deployment (Coolify/hosting providers)
+
+**Security → Credentials → Monitoring:**
+
+- Vaultwarden (credential management)
+- Email monitoring (SES)
+- Security auditing (code audit services)
+
+### **Workflow Documentation**
+
+Each service guide includes:
+
+- **Integration examples** with other services
+- **Workflow patterns** for common use cases
+- **Cross-service dependencies** and requirements
+- **Combined operations** examples
+
+## Finding Information
+
+### Quick Reference
+
+```bash
+# Service-specific information
+.agent/[SERVICE-NAME].md
+
+# Framework overview
+.agent/AGENTS.md
+
+# Provider selection guidance
+.agent/recommendations.md
+
+# Setup procedures
+.agent/[SERVICE]-SETUP.md
+```
+
+### **Search Patterns**
+
+- **Service capabilities**: Check service-specific guide
+- **Configuration help**: Check service guide + config templates
+- **Integration patterns**: Check service guide + best practices
+- **Troubleshooting**: Check service guide troubleshooting section
+- **Security guidance**: Check service guide security section
+
+---
+
+**All documentation is designed to provide comprehensive, accurate, and actionable information for both human users and AI assistants managing the DevOps framework.**