aidevops 2.52.1

package/.agent/aidevops/services.md

@@ -0,0 +1,357 @@
+---
+description: Complete service integration guide
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: true
+  glob: true
+  grep: true
+  webfetch: true
+---
+
+# Complete Service Integration Guide
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Infrastructure**: Hostinger (shared), Hetzner (VPS), Closte (VPS), Cloudron (apps)
+- **Deployment**: Coolify (self-hosted PaaS)
+- **Content**: MainWP (WordPress management)
+- **Security**: Vaultwarden (passwords/secrets)
+- **Quality**: CodeRabbit, CodeFactor, Codacy, SonarCloud
+- **Git**: GitHub, GitLab, Gitea, Local Git
+- **Email**: Amazon SES
+- **Domains**: Spaceship (with purchasing), 101domains
+- **DNS**: Cloudflare, Namecheap, Route 53
+- **Local**: Localhost, LocalWP, Context7 MCP, MCP Servers, Crawl4AI
+- **Setup**: Intelligent Setup Wizard
+- **Pattern**: Helper script + config file + docs for each service
+<!-- AI-CONTEXT-END -->
+
+## Infrastructure & Hosting (4 Services)
+
+### Hostinger
+
+- **Type**: Shared hosting provider
+- **Strengths**: Budget-friendly, WordPress optimized, easy management
+- **API**: REST API for account and hosting management
+- **Use Cases**: Small websites, WordPress sites, budget hosting
+- **Helper**: `hostinger-helper.sh`
+- **Config**: `hostinger-config.json`
+- **Docs**: `.agent/hostinger.md`
+
+### Hetzner Cloud
+
+- **Type**: German cloud VPS provider
+- **Strengths**: Excellent price/performance, reliable, EU-based
+- **API**: Comprehensive REST API for server management
+- **Use Cases**: VPS hosting, cloud infrastructure, European hosting
+- **Helper**: `hetzner-helper.sh`
+- **Config**: `hetzner-config.json`
+- **Docs**: `.agent/hetzner.md`
+
+### Closte
+
+- **Type**: VPS hosting provider
+- **Strengths**: Competitive pricing, good performance, multiple locations
+- **API**: REST API for server provisioning and management
+- **Use Cases**: VPS hosting, application hosting, development servers
+- **Helper**: `closte-helper.sh`
+- **Config**: `closte-config.json`
+- **Docs**: `.agent/closte.md`
+
+### Cloudron
+
+- **Type**: Self-hosted app platform
+- **Strengths**: Easy app deployment, automatic updates, backup management
+- **API**: REST API for app and server management
+- **Use Cases**: Self-hosted applications, team productivity, app management
+- **Helper**: `cloudron-helper.sh`
+- **Config**: `cloudron-config.json`
+- **Docs**: `.agent/cloudron.md`
+
+## Deployment & Orchestration (1 Service)
+
+### Coolify
+
+- **Type**: Self-hosted deployment platform
+- **Strengths**: Docker-based, Git integration, multiple deployment options
+- **API**: REST API for deployment and application management
+- **Use Cases**: Application deployment, CI/CD, container orchestration
+- **Helper**: `coolify-helper.sh`
+- **Config**: `coolify-config.json`
+- **Docs**: `.agent/coolify.md`
+
+## Content Management (1 Service)
+
+### MainWP
+
+- **Type**: WordPress management platform
+- **Strengths**: Centralized management, bulk operations, security monitoring
+- **API**: REST API for WordPress site management
+- **Use Cases**: Multiple WordPress sites, client management, bulk updates
+- **Helper**: `mainwp-helper.sh`
+- **Config**: `mainwp-config.json`
+- **Docs**: `.agent/mainwp.md`
+
+## Security & Secrets (1 Service)
+
+### Vaultwarden
+
+- **Type**: Self-hosted password manager (Bitwarden compatible)
+- **Strengths**: Self-hosted, secure, API access, team sharing
+- **API**: Bitwarden-compatible API for credential management
+- **MCP**: Bitwarden MCP server available
+- **Use Cases**: Password management, secure credential storage, team secrets
+- **Helper**: `vaultwarden-helper.sh`
+- **Config**: `vaultwarden-config.json`
+- **Docs**: `.agent/vaultwarden.md`
+
+## Code Quality & Auditing (4 Services)
+
+### CodeRabbit
+
+- **Type**: AI-powered code review platform
+- **Strengths**: AI analysis, context-aware reviews, security scanning
+- **API**: REST API for code analysis and reviews
+- **MCP**: CodeRabbit MCP server available
+- **Use Cases**: Automated code reviews, quality analysis, security scanning
+- **Helper**: `code-audit-helper.sh` (multi-service)
+- **Config**: `code-audit-config.json`
+- **Docs**: `.agent/code-auditing.md`
+
+### CodeFactor
+
+- **Type**: Automated code quality analysis
+- **Strengths**: Simple setup, clear metrics, GitHub integration
+- **API**: REST API for repository and issue management
+- **Use Cases**: Continuous code quality monitoring, technical debt tracking
+- **Helper**: `code-audit-helper.sh` (multi-service)
+- **Config**: `code-audit-config.json`
+- **Docs**: `.agent/code-auditing.md`
+
+### Codacy
+
+- **Type**: Automated code quality and security analysis
+- **Strengths**: Comprehensive metrics, team collaboration, custom rules
+- **API**: REST API for quality management
+- **MCP**: Codacy MCP server available
+- **Use Cases**: Enterprise code quality, team collaboration, compliance
+- **Helper**: `code-audit-helper.sh` (multi-service)
+- **Config**: `code-audit-config.json`
+- **Docs**: `.agent/code-auditing.md`
+
+### SonarCloud
+
+- **Type**: Professional code quality and security analysis
+- **Strengths**: Industry standard, comprehensive rules, quality gates
+- **API**: Extensive web API for analysis and reporting
+- **MCP**: SonarQube MCP server available
+- **Use Cases**: Professional development, security compliance, quality gates
+- **Helper**: `code-audit-helper.sh` (multi-service)
+- **Config**: `code-audit-config.json`
+- **Docs**: `.agent/code-auditing.md`
+
+## Version Control & Git Platforms (4 Services)
+
+### GitHub
+
+- **Type**: World's largest code hosting platform
+- **Strengths**: Massive community, excellent CI/CD, comprehensive API
+- **API**: Full REST API v4 with GraphQL support
+- **MCP**: Official GitHub MCP server available
+- **Use Cases**: Open source projects, team collaboration, enterprise development
+- **Helper**: `git-platforms-helper.sh` (multi-platform)
+- **Config**: `git-platforms-config.json`
+- **Docs**: `.agent/git-platforms.md`
+
+### GitLab
+
+- **Type**: Complete DevOps platform with integrated CI/CD
+- **Strengths**: Built-in CI/CD, security scanning, project management
+- **API**: Comprehensive REST API v4
+- **MCP**: Community GitLab MCP servers available
+- **Use Cases**: Enterprise DevOps, self-hosted solutions, integrated workflows
+- **Helper**: `git-platforms-helper.sh` (multi-platform)
+- **Config**: `git-platforms-config.json`
+- **Docs**: `.agent/git-platforms.md`
+
+### Gitea
+
+- **Type**: Lightweight self-hosted Git service
+- **Strengths**: Minimal resource usage, easy deployment, Git-focused
+- **API**: REST API compatible with GitHub API
+- **MCP**: Community Gitea MCP servers available
+- **Use Cases**: Self-hosted Git, private repositories, lightweight deployments
+- **Helper**: `git-platforms-helper.sh` (multi-platform)
+- **Config**: `git-platforms-config.json`
+- **Docs**: `.agent/git-platforms.md`
+
+### Local Git
+
+- **Type**: Local repository management and initialization
+- **Strengths**: Offline development, full control, no external dependencies
+- **Integration**: Seamless integration with remote platforms
+- **Use Cases**: Local development, repository initialization, offline work
+- **Helper**: `git-platforms-helper.sh` (multi-platform)
+- **Config**: `git-platforms-config.json`
+- **Docs**: `.agent/git-platforms.md`
+
+## Email Services (1 Service)
+
+### Amazon SES
+
+- **Type**: Scalable email delivery service
+- **Strengths**: High deliverability, comprehensive analytics, AWS integration
+- **API**: AWS API for email sending and management
+- **Use Cases**: Transactional emails, marketing emails, email monitoring
+- **Helper**: `ses-helper.sh`
+- **Config**: `ses-config.json`
+- **Docs**: `.agent/services/email/ses.md`
+
+## Communications Services (2 Services)
+
+### Twilio
+
+- **Type**: Cloud communications platform (CPaaS)
+- **Strengths**: Global coverage, comprehensive APIs, multi-channel (SMS, Voice, WhatsApp)
+- **API**: REST API for messaging, voice, verify, lookup
+- **Use Cases**: SMS notifications, voice calls, 2FA/OTP, WhatsApp Business, call recording
+- **Helper**: `twilio-helper.sh`
+- **Config**: `twilio-config.json`
+- **Docs**: `.agent/services/communications/twilio.md`
+- **AUP**: Must comply with Twilio Acceptable Use Policy
+
+### Telfon
+
+- **Type**: Twilio-powered cloud phone system with mobile/desktop apps
+- **Strengths**: User-friendly interface, mobile apps, WhatsApp integration, call recording
+- **Website**: https://mytelfon.com/
+- **Use Cases**: Sales teams, customer support, remote teams needing softphone
+- **Apps**: iOS, Android, Chrome Extension, Edge Add-on
+- **Docs**: `.agent/services/communications/telfon.md`
+- **Note**: Recommended for end users who need a calling/SMS interface
+
+## Domain & DNS (5 Services)
+
+### Spaceship
+
+- **Type**: Modern domain registrar with API purchasing
+- **Strengths**: API purchasing, transparent pricing, modern interface
+- **API**: REST API for domain management and purchasing
+- **Use Cases**: Domain purchasing, portfolio management, API automation
+- **Helper**: `spaceship-helper.sh`
+- **Config**: `spaceship-config.json`
+- **Docs**: `.agent/spaceship.md`, `.agent/domain-purchasing.md`
+
+### 101domains
+
+- **Type**: Comprehensive domain registrar with extensive TLD selection
+- **Strengths**: 1000+ TLDs, competitive pricing, bulk operations
+- **API**: REST API for domain management
+- **Use Cases**: Extensive TLD needs, bulk domain operations, reseller services
+- **Helper**: `101domains-helper.sh`
+- **Config**: `101domains-config.json`
+- **Docs**: `.agent/101DOMAINS.md`
+
+### Cloudflare DNS
+
+- **Type**: Global CDN and DNS provider
+- **Strengths**: Global network, DDoS protection, performance optimization
+- **API**: REST API for DNS and CDN management
+- **Use Cases**: DNS management, CDN, security, performance optimization
+- **Helper**: `dns-helper.sh` (multi-provider)
+- **Config**: `cloudflare-dns-config.json`
+- **Docs**: `.agent/dns-providers.md`
+
+### Namecheap DNS
+
+- **Type**: Domain registrar DNS hosting
+- **Strengths**: Integrated with domain registration, reliable, affordable
+- **API**: REST API for DNS management
+- **Use Cases**: DNS hosting for Namecheap domains, basic DNS needs
+- **Helper**: `dns-helper.sh` (multi-provider)
+- **Config**: `namecheap-dns-config.json`
+- **Docs**: `.agent/dns-providers.md`
+
+### Route 53
+
+- **Type**: AWS DNS service with advanced routing
+- **Strengths**: Advanced routing, health checks, AWS integration
+- **API**: AWS API for DNS management
+- **Use Cases**: Advanced DNS routing, health checks, AWS integration
+- **Helper**: `dns-helper.sh` (multi-provider)
+- **Config**: `route53-dns-config.json`
+- **Docs**: `.agent/dns-providers.md`
+
+## Development & Local (4 Services)
+
+### Localhost
+
+- **Type**: Local development environment with .local domains
+- **Strengths**: Local development, .local domain support, offline work
+- **Integration**: Integration with local services and development tools
+- **Use Cases**: Local development, testing, offline development
+- **Helper**: `localhost-helper.sh`
+- **Config**: `localhost-config.json`
+- **Docs**: `.agent/localhost.md`
+
+### LocalWP
+
+- **Type**: Local WordPress development environment
+- **Strengths**: Easy WordPress setup, database access, development tools
+- **MCP**: LocalWP MCP server for database access
+- **Use Cases**: WordPress development, local testing, database access
+- **Helper**: `localhost-helper.sh` (includes LocalWP)
+- **Config**: `localhost-config.json`
+- **Docs**: `.agent/localwp-mcp.md`
+
+### Context7 MCP
+
+- **Type**: Real-time documentation access for AI assistants
+- **Strengths**: Latest documentation, contextual information, AI integration
+- **MCP**: Context7 MCP server for documentation access
+- **Use Cases**: AI assistant documentation, real-time context, development help
+- **Helper**: Context7 integration in all helpers
+- **Config**: `context7-mcp-config.json`
+- **Docs**: `.agent/context7-mcp-setup.md`
+
+### MCP Servers
+
+- **Type**: Model Context Protocol server management
+- **Strengths**: Real-time data access, AI integration, standardized protocol
+- **Integration**: MCP servers for all supported services
+- **Use Cases**: AI assistant data access, real-time integration, automation
+- **Helper**: MCP integration in all helpers
+- **Config**: `mcp-servers-config.json`
+- **Docs**: `.agent/mcp-servers.md`
+
+### Crawl4AI
+
+- **Type**: AI-powered web crawler and scraper for LLM-friendly data extraction
+- **Strengths**: LLM-ready output, structured extraction, advanced browser control, high performance
+- **API**: Comprehensive REST API with job queue and webhook support
+- **MCP**: Native MCP server integration for AI assistants
+- **Use Cases**: Web scraping, content research, data extraction, RAG pipelines
+- **Helper**: `crawl4ai-helper.sh`
+- **Config**: `crawl4ai-config.json`
+- **Docs**: `.agent/crawl4ai.md`
+
+## Setup & Configuration (1 Service)
+
+### Intelligent Setup Wizard
+
+- **Type**: AI-guided infrastructure setup and configuration
+- **Strengths**: Intelligent recommendations, guided setup, best practices
+- **Integration**: Integrates with all framework services
+- **Use Cases**: Initial setup, service recommendations, configuration guidance
+- **Helper**: `setup-wizard-helper.sh`
+- **Config**: `setup-wizard-responses.json` (generated)
+- **Docs**: Integrated in all service documentation
+
+---
+
+**This comprehensive service integration provides complete DevOps infrastructure management capabilities across all major service categories.**

package/.agent/aidevops/setup.md

@@ -0,0 +1,153 @@
+---
+description: AI assistant guide for setup.sh script
+mode: subagent
+tools:
+  read: true
+  write: true
+  edit: true
+  bash: true
+  glob: true
+  grep: true
+  webfetch: false
+---
+
+# Setup Guide - AI Assistant for setup.sh
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Script**: `~/Git/aidevops/setup.sh`
+- **Purpose**: Deploy aidevops agents to user's system
+- **Target**: `~/.aidevops/agents/`
+
+**What setup.sh does**:
+1. Checks system requirements (jq, curl, ssh)
+2. Checks optional dependencies (sshpass, git CLIs)
+3. Copies `.agent/` contents to `~/.aidevops/agents/`
+4. Backs up existing configs to `~/.aidevops/config-backups/[timestamp]/`
+5. Injects reference into AI assistant AGENTS.md files
+6. Updates OpenCode agent paths in `opencode.json`
+
+**Run**:
+
+```bash
+cd ~/Git/aidevops
+./setup.sh
+```text
+
+**Post-setup locations**:
+- Agents: `~/.aidevops/agents/`
+- Backups: `~/.aidevops/config-backups/`
+- Credentials: `~/.config/aidevops/mcp-env.sh`
+
+<!-- AI-CONTEXT-END -->
+
+## Detailed Setup Process
+
+### Prerequisites
+
+**Required:**
+- `jq` - JSON processing
+- `curl` - HTTP requests
+- `ssh` - Server access
+
+**Optional:**
+- `sshpass` - Password-based SSH (for Hostinger)
+- `gh` - GitHub CLI
+- `glab` - GitLab CLI
+- `tea` - Gitea CLI
+
+### What Gets Deployed
+
+```text
+~/.aidevops/
+├── agents/                    # Full agent structure
+│   ├── AGENTS.md             # User entry point
+│   ├── aidevops.md           # Main agents
+│   ├── wordpress.md
+│   ├── aidevops/             # Subagent folders
+│   ├── tools/
+│   ├── services/
+│   ├── workflows/
+│   └── scripts/              # Helper scripts
+└── config-backups/           # Timestamped backups
+    └── [YYYYMMDD_HHMMSS]/
+```text
+
+### AI Assistant Integration
+
+Setup.sh adds this line to AI assistant config files:
+
+```text
+Add ~/.aidevops/agents/AGENTS.md to context for AI DevOps capabilities.
+```text
+
+**Files modified:**
+- `~/.opencode/AGENTS.md`
+- `~/.cursor/AGENTS.md`
+- `~/.claude/AGENTS.md`
+- `~/.config/cursor/AGENTS.md`
+
+### OpenCode Configuration
+
+Setup.sh updates `~/.config/opencode/opencode.json` agent paths to point to `~/.aidevops/agents/`.
+
+**Backup created before modification.**
+
+### Manual Configuration
+
+If setup.sh doesn't support your AI assistant:
+
+1. Add to your AI assistant's AGENTS.md or config:
+
+   ```text
+   Add ~/.aidevops/agents/AGENTS.md to context for AI DevOps capabilities.
+   ```
+
+2. Point agent configurations to `~/.aidevops/agents/[agent].md`
+
+### Updating
+
+Re-run setup.sh after pulling updates:
+
+```bash
+cd ~/Git/aidevops
+git pull
+./setup.sh
+```text
+
+Previous configs are backed up automatically.
+
+### Troubleshooting
+
+**"Command not found" errors:**
+
+```bash
+# Install missing dependencies
+brew install jq curl  # macOS
+apt-get install jq curl  # Ubuntu/Debian
+```text
+
+**OpenCode not finding agents:**
+- Check `~/.config/opencode/opencode.json` agent paths
+- Verify `~/.aidevops/agents/` exists and contains files
+- See `tools/opencode/opencode.md` for path details
+
+**Permissions issues:**
+
+```bash
+# Ensure correct permissions
+chmod 600 ~/.config/aidevops/mcp-env.sh
+chmod 755 ~/.aidevops/agents/scripts/*.sh
+```text
+
+## Future Enhancements
+
+**Terminal UI** (planned): Interactive setup with options for:
+- Selecting which AI assistants to configure
+- Choosing which agents to deploy
+- Custom configuration paths
+- Visual progress indicators
+
+For now, setup.sh runs all steps automatically. See the script source for customization.