aidevops 2.52.1 → 2.53.2

package/.agent/aidevops/configs.md

@@ -1,274 +0,0 @@
----
-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

@@ -1,244 +0,0 @@
----
-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.**