aidevops 2.52.1 → 2.53.2

package/.agent/aidevops/services.md

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

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