aidevops 2.52.1 → 2.53.1

package/.agent/services/hosting/dns-providers.md

@@ -1,335 +0,0 @@
----
-description: DNS provider configuration and management
-mode: subagent
-tools:
-  read: true
-  write: false
-  edit: false
-  bash: true
-  glob: true
-  grep: true
-  webfetch: true
----
-
-# DNS Providers Configuration Guide
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- **Providers**: Cloudflare, Namecheap, Route 53
-- **Unified command**: `dns-helper.sh [records|add|update|delete] [provider] [account] [domain] [args]`
-- **Configs**: `cloudflare-dns-config.json`, `namecheap-dns-config.json`, `route53-dns-config.json`
-- **Cloudflare**: API token auth, proxy support, analytics
-- **Namecheap**: API user + key + whitelisted IP
-- **Route 53**: AWS IAM credentials, health checks, geo/weighted routing
-- **Record types**: A, AAAA, CNAME, MX, TXT, CAA, NS
-- **Operations**: `propagation-check`, `export`, `import`, `backup`, `compare`
-- **Security**: DNSSEC, CAA records, audit logging
-<!-- AI-CONTEXT-END -->
-
-This guide covers DNS management across multiple providers including Cloudflare, Namecheap, Route 53, and other DNS services through a unified interface.
-
-## DNS Providers Overview
-
-### **Supported DNS Providers:**
-
-- **Cloudflare DNS** - Global CDN with comprehensive DNS management
-- **Namecheap DNS** - Domain registrar with integrated DNS hosting
-- **Route 53** - AWS DNS service with advanced routing capabilities
-- **Other DNS Providers** - Generic DNS provider support
-
-### **Unified DNS Management:**
-
-The DNS helper provides a consistent interface across all providers while maintaining provider-specific configurations and capabilities.
-
-## 🔧 **Configuration**
-
-### **Provider-Specific Configurations:**
-
-#### **Cloudflare DNS:**
-
-```bash
-# Copy template
-cp configs/cloudflare-dns-config.json.txt configs/cloudflare-dns-config.json
-```
-
-```json
-{
-  "accounts": {
-    "personal": {
-      "api_token": "YOUR_CLOUDFLARE_API_TOKEN_HERE",
-      "email": "your-email@domain.com",
-      "description": "Personal Cloudflare account"
-    }
-  }
-}
-```
-
-#### **Namecheap DNS:**
-
-```bash
-# Copy template
-cp configs/namecheap-dns-config.json.txt configs/namecheap-dns-config.json
-```
-
-```json
-{
-  "accounts": {
-    "personal": {
-      "api_user": "your-namecheap-username",
-      "api_key": "YOUR_NAMECHEAP_API_KEY_HERE",
-      "client_ip": "YOUR_WHITELISTED_IP_HERE",
-      "description": "Personal Namecheap account"
-    }
-  }
-}
-```
-
-#### **Route 53:**
-
-```bash
-# Copy template
-cp configs/route53-dns-config.json.txt configs/route53-dns-config.json
-```
-
-```json
-{
-  "accounts": {
-    "production": {
-      "aws_access_key_id": "YOUR_AWS_ACCESS_KEY_ID_HERE",
-      "aws_secret_access_key": "YOUR_AWS_SECRET_ACCESS_KEY_HERE",
-      "region": "us-east-1",
-      "description": "Production AWS account"
-    }
-  }
-}
-```
-
-## 🚀 **Usage Examples**
-
-### **Unified DNS Commands:**
-
-```bash
-# List DNS records across providers
-./.agent/scripts/dns-helper.sh records cloudflare personal example.com
-./.agent/scripts/dns-helper.sh records namecheap personal example.com
-./.agent/scripts/dns-helper.sh records route53 production example.com
-
-# Add DNS records
-./.agent/scripts/dns-helper.sh add cloudflare personal example.com www A 192.168.1.100
-./.agent/scripts/dns-helper.sh add namecheap personal example.com mail A 192.168.1.101
-./.agent/scripts/dns-helper.sh add route53 production example.com api A 192.168.1.102
-
-# Update DNS records
-./.agent/scripts/dns-helper.sh update cloudflare personal example.com record-id www A 192.168.1.200
-
-# Delete DNS records
-./.agent/scripts/dns-helper.sh delete cloudflare personal example.com record-id
-```
-
-### **Provider-Specific Features:**
-
-#### **Cloudflare Advanced Features:**
-
-```bash
-# Enable Cloudflare proxy
-./.agent/scripts/dns-helper.sh proxy-enable cloudflare personal example.com record-id
-
-# Configure page rules
-./.agent/scripts/dns-helper.sh page-rule cloudflare personal example.com "*.example.com/*" cache-everything
-
-# Get analytics
-./.agent/scripts/dns-helper.sh analytics cloudflare personal example.com
-```
-
-#### **Route 53 Advanced Features:**
-
-```bash
-# Create health check
-./.agent/scripts/dns-helper.sh health-check route53 production example.com https://example.com/health
-
-# Configure weighted routing
-./.agent/scripts/dns-helper.sh weighted-routing route53 production example.com www A 192.168.1.100 50
-
-# Set up geolocation routing
-./.agent/scripts/dns-helper.sh geo-routing route53 production example.com www A 192.168.1.100 US
-```
-
-## 🛡️ **Security Best Practices**
-
-### **API Security:**
-
-- **Token scoping**: Use API tokens with minimal required permissions
-- **Regular rotation**: Rotate API credentials every 6-12 months
-- **Secure storage**: Store credentials in secure configuration files
-- **Access monitoring**: Monitor API usage and access patterns
-- **IP restrictions**: Use IP restrictions where supported
-
-### **DNS Security:**
-
-```bash
-# Enable DNSSEC (where supported)
-./.agent/scripts/dns-helper.sh enable-dnssec cloudflare personal example.com
-
-# Configure CAA records
-./.agent/scripts/dns-helper.sh add cloudflare personal example.com @ CAA "0 issue letsencrypt.org"
-
-# Set up monitoring
-./.agent/scripts/dns-helper.sh monitor cloudflare personal example.com
-```
-
-### **Access Control:**
-
-- **Multi-factor authentication**: Enable MFA on all DNS provider accounts
-- **Role-based access**: Use role-based access control where available
-- **Audit logging**: Enable audit logging for all DNS changes
-- **Change approval**: Implement change approval workflows for critical domains
-- **Backup configurations**: Maintain backups of DNS configurations
-
-## 🔍 **Troubleshooting**
-
-### **Common Issues:**
-
-#### **DNS Propagation:**
-
-```bash
-# Check DNS propagation
-dig @8.8.8.8 example.com
-nslookup example.com 1.1.1.1
-
-# Test from multiple locations
-./.agent/scripts/dns-helper.sh propagation-check example.com
-
-# Check TTL values
-./.agent/scripts/dns-helper.sh ttl-check example.com
-```
-
-#### **API Authentication:**
-
-```bash
-# Test API connectivity
-./.agent/scripts/dns-helper.sh test-auth cloudflare personal
-./.agent/scripts/dns-helper.sh test-auth namecheap personal
-./.agent/scripts/dns-helper.sh test-auth route53 production
-
-# Verify API permissions
-./.agent/scripts/dns-helper.sh check-permissions cloudflare personal
-```
-
-#### **Record Conflicts:**
-
-```bash
-# Check for conflicting records
-./.agent/scripts/dns-helper.sh conflict-check cloudflare personal example.com
-
-# Validate DNS configuration
-./.agent/scripts/dns-helper.sh validate cloudflare personal example.com
-
-# Compare configurations across providers
-./.agent/scripts/dns-helper.sh compare example.com cloudflare:personal namecheap:personal
-```
-
-## 📊 **Monitoring & Analytics**
-
-### **DNS Health Monitoring:**
-
-```bash
-# Monitor DNS resolution
-./.agent/scripts/dns-helper.sh monitor-resolution example.com
-
-# Check DNS performance
-./.agent/scripts/dns-helper.sh performance-check example.com
-
-# Monitor DNS changes
-./.agent/scripts/dns-helper.sh change-log cloudflare personal example.com
-```
-
-### **Analytics & Reporting:**
-
-```bash
-# Get DNS query analytics (Cloudflare)
-./.agent/scripts/dns-helper.sh analytics cloudflare personal example.com
-
-# Generate DNS report
-./.agent/scripts/dns-helper.sh report cloudflare personal example.com
-
-# Export DNS configuration
-./.agent/scripts/dns-helper.sh export cloudflare personal example.com > dns-backup.json
-```
-
-## 🔄 **Migration & Backup**
-
-### **DNS Migration:**
-
-```bash
-# Export DNS records from source
-./.agent/scripts/dns-helper.sh export namecheap personal example.com > source-dns.json
-
-# Import DNS records to destination
-./.agent/scripts/dns-helper.sh import cloudflare personal example.com source-dns.json
-
-# Verify migration
-./.agent/scripts/dns-helper.sh compare example.com namecheap:personal cloudflare:personal
-```
-
-### **Backup & Restore:**
-
-```bash
-# Backup DNS configuration
-./.agent/scripts/dns-helper.sh backup cloudflare personal example.com
-
-# Restore DNS configuration
-./.agent/scripts/dns-helper.sh restore cloudflare personal example.com backup-file.json
-
-# Schedule automated backups
-./.agent/scripts/dns-helper.sh schedule-backup cloudflare personal daily
-```
-
-## 📚 **Best Practices**
-
-### **DNS Management:**
-
-1. **Consistent TTL values**: Use appropriate TTL values for different record types
-2. **Change documentation**: Document all DNS changes with reasons
-3. **Testing procedures**: Test DNS changes in staging environments first
-4. **Rollback plans**: Have rollback procedures for DNS changes
-5. **Monitoring**: Monitor DNS resolution and performance continuously
-
-### **Multi-Provider Strategy:**
-
-- **Primary/secondary**: Use primary and secondary DNS providers for redundancy
-- **Geographic distribution**: Use different providers in different regions
-- **Load balancing**: Distribute DNS queries across multiple providers
-- **Failover**: Implement automatic failover between providers
-- **Cost optimization**: Balance cost and performance across providers
-
-### **Automation:**
-
-- **Infrastructure as Code**: Manage DNS configurations as code
-- **CI/CD integration**: Integrate DNS changes into deployment pipelines
-- **Automated testing**: Test DNS configurations automatically
-- **Change approval**: Implement automated change approval workflows
-- **Monitoring integration**: Integrate with monitoring and alerting systems
-
-## 🎯 **AI Assistant Integration**
-
-### **Automated DNS Management:**
-
-- **Intelligent routing**: AI-driven DNS routing decisions
-- **Performance optimization**: Automated DNS performance optimization
-- **Security monitoring**: Automated DNS security monitoring
-- **Change management**: Automated DNS change management and approval
-- **Incident response**: Automated DNS incident detection and response
-
-### **Multi-Provider Orchestration:**
-
-- **Provider selection**: AI-driven provider selection based on performance
-- **Load balancing**: Intelligent load balancing across DNS providers
-- **Failover management**: Automated failover between DNS providers
-- **Cost optimization**: AI-driven cost optimization across providers
-- **Compliance monitoring**: Automated compliance monitoring across providers
-
----
-
-**The unified DNS management system provides comprehensive DNS capabilities across multiple providers with consistent interfaces and advanced automation features.** 🚀

package/.agent/services/hosting/domain-purchasing.md

@@ -1,344 +0,0 @@
----
-description: Domain purchasing and management guide
-mode: subagent
-tools:
-  read: true
-  write: false
-  edit: false
-  bash: false
-  glob: true
-  grep: true
-  webfetch: true
----
-
-# Domain Purchasing & Management Guide
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-**Supported Registrars with API Purchasing**:
-- **Spaceship**: 500+ TLDs, bulk ops, auto-renewal
-- **101domains**: 1000+ TLDs, premium domains, reseller support
-
-**Commands** (spaceship-helper.sh):
-- `check-availability <account> <domain>` - Check single domain
-- `bulk-check <account> <domains...>` - Check multiple domains
-- `purchase <account> <domain> <years> <auto_renew>` - Buy domain (requires confirmation)
-- `domains <account>` - List registered domains
-- `monitor-expiration <account> <days>` - Check expiring domains
-
-**Security**: Confirmation required, spending limits configurable, audit trails
-
-**TLD Recommendations**:
-- Web apps: .com, .app, .io
-- Tech: .dev, .tech, .ai
-- E-commerce: .shop, .store
-<!-- AI-CONTEXT-END -->
-
-Comprehensive domain purchasing, availability checking, and management across multiple registrars with AI assistant automation.
-
-## 🏢 **Domain Registrars with API Purchasing**
-
-### **Supported Registrars:**
-
-#### **Spaceship**
-
-- **API Purchasing**: ✅ Full API support for domain purchasing
-- **Availability Check**: Real-time domain availability checking
-- **Pricing**: Transparent API pricing information
-- **TLD Support**: 500+ TLDs available
-- **Features**: Instant registration, bulk operations, auto-renewal
-
-#### **101domains**
-
-- **API Purchasing**: ✅ Comprehensive domain purchasing API
-- **Availability Check**: Bulk availability checking
-- **Pricing**: Competitive pricing across 1000+ TLDs
-- **TLD Support**: Extensive TLD portfolio including new gTLDs
-- **Features**: Premium domains, bulk registration, reseller support
-
-#### **Future Support:**
-
-- **Namecheap**: API purchasing capabilities being developed
-- **Other registrars**: Additional registrars with API support
-
-## 🔧 **Configuration**
-
-### **Enhanced Registrar Configuration:**
-
-```json
-{
-  "accounts": {
-    "personal": {
-      "api_token": "YOUR_SPACESHIP_API_TOKEN_HERE",
-      "email": "your-email@domain.com",
-      "description": "Personal Spaceship account",
-      "auto_renew_default": true,
-      "default_years": 1,
-      "purchasing_enabled": true
-    }
-  },
-  "purchasing_settings": {
-    "confirmation_required": true,
-    "max_purchase_amount": 500,
-    "auto_configure_dns": true,
-    "default_nameservers": [
-      "ns1.spaceship.com",
-      "ns2.spaceship.com"
-    ]
-  }
-}
-```
-
-## 🚀 **Domain Purchasing Usage**
-
-### **Domain Availability Checking:**
-
-```bash
-# Check single domain availability
-./.agent/scripts/spaceship-helper.sh check-availability personal example.com
-
-# Bulk check multiple domains
-./.agent/scripts/spaceship-helper.sh bulk-check personal example.com example.net example.org
-
-# Check with pricing information
-./.agent/scripts/spaceship-helper.sh check-availability personal premium-domain.com
-```
-
-### **Domain Purchasing:**
-
-```bash
-# Purchase domain (with confirmation prompt)
-./.agent/scripts/spaceship-helper.sh purchase personal mynewdomain.com 1 true
-
-# Purchase domain for multiple years
-./.agent/scripts/spaceship-helper.sh purchase personal longterm-project.com 3 true
-
-# Purchase without auto-renewal
-./.agent/scripts/spaceship-helper.sh purchase personal temporary-project.com 1 false
-```
-
-### **Domain Portfolio Management:**
-
-```bash
-# List all registered domains
-./.agent/scripts/spaceship-helper.sh domains personal
-
-# Get domain details including expiration
-./.agent/scripts/spaceship-helper.sh domain-details personal mydomain.com
-
-# Monitor domains expiring soon
-./.agent/scripts/spaceship-helper.sh monitor-expiration personal 30
-```
-
-## 🛡️ **Purchasing Security & Best Practices**
-
-### **Purchase Confirmation:**
-
-```bash
-# Example purchase flow with confirmation:
-$ ./.agent/scripts/spaceship-helper.sh purchase personal newproject.com 1 true
-
-[INFO] Checking availability before purchase...
-[SUCCESS] Domain newproject.com is available for registration
-Price: $12.99
-[WARNING] Domain newproject.com will be purchased for $12.99 for 1 year(s)
-[WARNING] This action will charge your account. Continue? (y/N)
-y
-[INFO] Purchasing domain: newproject.com
-[SUCCESS] Domain purchased successfully
-```
-
-### **Security Measures:**
-
-- **Confirmation prompts**: All purchases require explicit confirmation
-- **Spending limits**: Configure maximum purchase amounts
-- **Account verification**: Verify account balance before purchases
-- **Audit trails**: All purchases are logged and auditable
-- **Access control**: Restrict purchasing to authorized users
-
-### **Financial Controls:**
-
-```bash
-# Set spending limits in configuration
-{
-  "purchasing_settings": {
-    "confirmation_required": true,
-    "max_purchase_amount": 500,
-    "daily_purchase_limit": 10,
-    "require_approval_over": 100
-  }
-}
-```
-
-## 🔍 **Domain Research & Analysis**
-
-### **Availability Analysis:**
-
-```bash
-# Comprehensive domain research
-./.agent/scripts/spaceship-helper.sh bulk-check personal \
-  myproject.com myproject.net myproject.org \
-  myproject.io myproject.app myproject.dev
-
-# Check premium domain pricing
-./.agent/scripts/spaceship-helper.sh check-availability personal premium-name.com
-```
-
-### **TLD Recommendations:**
-
-```bash
-# AI assistant can recommend TLDs based on project type:
-# Web applications: .com, .app, .io
-# Technology projects: .dev, .tech, .ai
-# Organizations: .org, .foundation
-# Local businesses: .local, country-specific TLDs
-# E-commerce: .shop, .store, .buy
-```
-
-## 🤖 **AI Assistant Domain Purchasing**
-
-### **Intelligent Domain Selection:**
-
-The AI assistant can help with:
-
-- **Name generation**: Generate domain name suggestions based on project description
-- **Availability checking**: Check availability across multiple TLDs
-- **Price comparison**: Compare prices across different registrars
-- **TLD recommendations**: Suggest appropriate TLDs for specific use cases
-- **Bulk operations**: Handle multiple domain purchases efficiently
-
-### **Automated Purchase Workflows:**
-
-```bash
-# AI assistant workflow example:
-1. Project analysis: "I need a domain for my e-commerce project selling handmade crafts"
-2. Name suggestions: Generate relevant domain names
-3. Availability check: Check availability across recommended TLDs
-4. Price analysis: Compare pricing and renewal costs
-5. Purchase recommendation: Recommend best options
-6. Automated purchase: Execute purchase with user confirmation
-7. DNS setup: Configure initial DNS settings
-8. Integration: Add domain to project configuration
-```
-
-### **Project-Based Domain Management:**
-
-```bash
-# AI can manage domains by project:
-./.agent/scripts/setup-wizard-helper.sh assess
-# Based on project type, AI recommends and can purchase:
-# - Primary domain (.com)
-# - Development domain (.dev)
-# - Staging domain (.staging.yourdomain.com)
-# - API domain (api.yourdomain.com)
-```
-
-## 📊 **Domain Portfolio Analytics**
-
-### **Portfolio Overview:**
-
-```bash
-# Get comprehensive portfolio overview
-./.agent/scripts/spaceship-helper.sh domains personal
-
-# Monitor expiration dates
-./.agent/scripts/spaceship-helper.sh monitor-expiration personal 60
-
-# Audit domain configuration
-./.agent/scripts/spaceship-helper.sh audit personal mydomain.com
-```
-
-### **Cost Analysis:**
-
-```bash
-# Calculate total domain costs
-for domain in $(./.agent/scripts/spaceship-helper.sh domains personal | awk '{print $1}'); do
-    echo "Analyzing costs for: $domain"
-    ./.agent/scripts/spaceship-helper.sh domain-details personal $domain | grep -E "(price|renewal|expiration)"
-done
-```
-
-## 🔄 **Integration with Development Workflow**
-
-### **Project Initialization with Domain:**
-
-```bash
-# Complete project setup with domain
-1. Domain research and purchase:
-   ./.agent/scripts/spaceship-helper.sh bulk-check personal myproject.com myproject.dev
-   ./.agent/scripts/spaceship-helper.sh purchase personal myproject.com 1 true
-
-2. DNS configuration:
-   ./.agent/scripts/dns-helper.sh add cloudflare personal myproject.com @ A 192.168.1.100
-   ./.agent/scripts/dns-helper.sh add cloudflare personal myproject.com www CNAME myproject.com
-
-3. SSL certificate setup:
-   # Automatic with Cloudflare or manual certificate installation
-
-4. Project deployment:
-   ./.agent/scripts/coolify-helper.sh deploy production myproject myproject.com
-```
-
-### **Multi-Environment Domain Strategy:**
-
-```bash
-# Purchase domains for different environments
-./.agent/scripts/spaceship-helper.sh purchase personal myproject.com 1 true      # Production
-./.agent/scripts/spaceship-helper.sh purchase personal myproject.dev 1 true     # Development
-./.agent/scripts/spaceship-helper.sh purchase personal myproject.app 1 true     # Mobile app
-
-# Configure DNS for each environment
-./.agent/scripts/dns-helper.sh add cloudflare personal myproject.com @ A 192.168.1.100
-./.agent/scripts/dns-helper.sh add cloudflare personal myproject.dev @ A 192.168.1.101
-./.agent/scripts/dns-helper.sh add cloudflare personal myproject.app @ A 192.168.1.102
-```
-
-## 📚 **Best Practices**
-
-### **Domain Selection:**
-
-1. **Brand consistency**: Choose domains that align with your brand
-2. **TLD strategy**: Select appropriate TLDs for your use case
-3. **Future planning**: Consider future expansion and additional domains
-4. **SEO considerations**: Choose SEO-friendly domain names
-5. **Legal protection**: Consider trademark implications
-
-### **Portfolio Management:**
-
-- **Renewal monitoring**: Monitor expiration dates and set up auto-renewal
-- **DNS management**: Keep DNS records organized and documented
-- **Security**: Enable domain locking and two-factor authentication
-- **Backup**: Maintain backup DNS configurations
-- **Documentation**: Document domain purposes and configurations
-
-### **Cost Optimization:**
-
-- **Bulk purchases**: Take advantage of bulk pricing when available
-- **Long-term registration**: Consider multi-year registrations for discounts
-- **Renewal planning**: Plan renewals to avoid premium pricing
-- **Portfolio review**: Regularly review and optimize domain portfolio
-- **Transfer opportunities**: Consider transferring domains for better pricing
-
-## 🎯 **AI Assistant Capabilities**
-
-### **Automated Domain Management:**
-
-- **Intelligent suggestions**: AI can suggest domain names based on project requirements
-- **Availability monitoring**: AI can monitor and alert on domain availability
-- **Purchase automation**: AI can execute domain purchases with proper safeguards
-- **Portfolio optimization**: AI can analyze and optimize domain portfolios
-- **Renewal management**: AI can manage domain renewals and notifications
-
-### **Integration with DevOps:**
-
-- **Project setup**: AI can purchase domains as part of project initialization
-- **Environment management**: AI can manage domains across development environments
-- **DNS automation**: AI can configure DNS settings automatically
-- **SSL management**: AI can coordinate SSL certificate setup
-- **Deployment integration**: AI can integrate domain setup with deployment workflows
-
----
-
-**The domain purchasing framework provides comprehensive domain management capabilities with AI assistant automation for seamless project setup and portfolio management.** 🚀