claude-autopm 2.8.2 → 2.8.3

package/packages/plugin-cloud/rules/infrastructure-pipeline.md

@@ -0,0 +1,128 @@
+# Infrastructure Operations Pipeline
+
+> **CRITICAL**: Infrastructure changes require strict validation and rollback capabilities.
+
+## 1. TERRAFORM DEPLOYMENT PIPELINE
+
+**Trigger**: Infrastructure as Code changes
+**Sequence**:
+
+```
+1. terraform-infrastructure-expert → Validate configuration
+2. Run terraform plan and review changes
+3. Write infrastructure tests (Terratest)
+4. Apply to staging environment first
+5. test-runner → Verify infrastructure health
+6. Document changes in CHANGELOG
+7. Apply to production with approval
+```
+
+## 2. CONTAINER BUILD PIPELINE
+
+**Trigger**: Dockerfile or container changes
+**Sequence**:
+
+```
+1. docker-containerization-expert → Optimize Dockerfile
+2. Security scan with Trivy/Snyk
+3. Build multi-stage image
+4. test-runner → Test container functionality
+5. Push to registry with proper tags
+6. Never push unscanned images
+```
+
+## 3. KUBERNETES DEPLOYMENT PIPELINE
+
+**Trigger**: K8s manifest or Helm chart changes
+**Sequence**:
+
+```
+1. kubernetes-orchestrator → Validate manifests
+2. Dry-run deployment
+3. Apply to dev/staging cluster
+4. test-runner → Verify pod health
+5. Monitor resource usage
+6. Rollout to production with canary
+```
+
+## 4. CLOUD FUNCTION PIPELINE
+
+**Trigger**: Serverless function deployment
+**Sequence**:
+
+```
+1. gcp-cloud-functions-engineer → Optimize function
+2. Set memory/timeout limits
+3. Configure triggers and IAM
+4. test-runner → Integration tests
+5. Deploy with gradual rollout
+6. Monitor cold starts and errors
+```
+
+## 5. CI/CD PIPELINE SETUP
+
+**Trigger**: GitHub Actions or Azure DevOps setup
+**Sequence**:
+
+```
+1. github-operations-specialist → Design pipeline
+2. Implement security scanning
+3. Add quality gates
+4. test-runner → Test pipeline stages
+5. Document pipeline flow
+6. Set up notifications
+```
+
+## 6. MESSAGING SYSTEM PIPELINE
+
+**Trigger**: NATS implementation
+**Sequence**:
+
+```
+1. nats-messaging-expert → Design topology
+2. Configure JetStream persistence
+3. Implement pub/sub patterns
+4. test-runner → Test message delivery
+5. Monitor throughput and latency
+6. Document message contracts
+```
+
+## 7. DATA PIPELINE ORCHESTRATION
+
+**Trigger**: Airflow/Kedro workflow setup
+**Sequence**:
+
+```
+1. airflow-orchestration-expert/kedro-pipeline-expert → Design DAG/pipeline
+2. Implement idempotent tasks
+3. Add monitoring and alerts
+4. test-runner → Test pipeline execution
+5. Verify data quality checks
+6. Document dependencies
+```
+
+## Pipeline Requirements
+
+### NEVER ALLOWED
+
+- ❌ Deploying without staging validation
+- ❌ Pushing unscanned container images
+- ❌ Applying Terraform without plan review
+- ❌ Skipping rollback procedures
+- ❌ Ignoring security vulnerabilities
+
+### ALWAYS REQUIRED
+
+- ✅ Infrastructure as Code for everything
+- ✅ Security scanning at every stage
+- ✅ Staging environment validation
+- ✅ Automated rollback capability
+- ✅ Comprehensive monitoring
+
+## Success Metrics
+
+- Zero unplanned downtime
+- All images pass security scan
+- Terraform drift detection active
+- Rollback time < 5 minutes
+- 100% infrastructure test coverage

package/packages/plugin-cloud/scripts/examples/aws-validate.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# AWS environment validation example
+# Usage: ./aws-validate.sh
+
+set -euo pipefail
+
+echo "🔍 Validating AWS environment..."
+
+# Check AWS CLI is installed
+if ! command -v aws &> /dev/null; then
+    echo "❌ AWS CLI not found. Please install it first."
+    exit 1
+fi
+
+# Verify AWS credentials
+echo "📋 Checking AWS credentials..."
+aws sts get-caller-identity
+
+# Check default region
+echo "🌍 Current region: $(aws configure get region)"
+
+# List available regions
+echo "📍 Available regions:"
+aws ec2 describe-regions --output table
+
+# Validate IAM permissions
+echo "🔐 Checking IAM permissions..."
+aws iam get-user || echo "⚠️  IAM user access may be limited"
+
+echo "✅ AWS environment validation complete"

package/packages/plugin-cloud/scripts/examples/azure-setup.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# Azure environment setup example
+# Usage: ./azure-setup.sh
+
+set -euo pipefail
+
+echo "🔍 Setting up Azure environment..."
+
+# Check Azure CLI is installed
+if ! command -v az &> /dev/null; then
+    echo "❌ Azure CLI not found. Please install it first."
+    exit 1
+fi
+
+# Check login status
+echo "📋 Checking Azure login status..."
+az account show || {
+    echo "🔐 Not logged in. Starting login..."
+    az login
+}
+
+# List subscriptions
+echo "📋 Available subscriptions:"
+az account list --output table
+
+# Set default subscription (if needed)
+# az account set --subscription "Your-Subscription-Name"
+
+# Validate resource providers
+echo "🔍 Checking resource providers..."
+az provider list --query "[?registrationState=='Registered'].namespace" --output table
+
+echo "✅ Azure environment setup complete"

package/packages/plugin-cloud/scripts/examples/gcp-setup.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# GCP environment setup example
+# Usage: ./gcp-setup.sh [project-id]
+
+set -euo pipefail
+
+PROJECT_ID="${1:-}"
+
+echo "🔍 Setting up GCP environment..."
+
+# Check gcloud CLI is installed
+if ! command -v gcloud &> /dev/null; then
+    echo "❌ gcloud CLI not found. Please install it first."
+    exit 1
+fi
+
+# Check login status
+echo "📋 Checking GCP login status..."
+gcloud auth list
+
+# Set project if provided
+if [ -n "$PROJECT_ID" ]; then
+    echo "🔧 Setting project to: $PROJECT_ID"
+    gcloud config set project "$PROJECT_ID"
+fi
+
+# List projects
+echo "📋 Available projects:"
+gcloud projects list
+
+# Show current configuration
+echo "⚙️  Current configuration:"
+gcloud config list
+
+# Enable required APIs (example)
+# gcloud services enable compute.googleapis.com
+# gcloud services enable container.googleapis.com
+
+echo "✅ GCP environment setup complete"

package/packages/plugin-cloud/scripts/examples/k8s-validate.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# Kubernetes cluster validation example
+# Usage: ./k8s-validate.sh [context]
+
+set -euo pipefail
+
+CONTEXT="${1:-$(kubectl config current-context)}"
+
+echo "🔍 Validating Kubernetes cluster: ${CONTEXT}..."
+
+# Check kubectl is installed
+if ! command -v kubectl &> /dev/null; then
+    echo "❌ kubectl not found. Please install it first."
+    exit 1
+fi
+
+# Use specified context
+kubectl config use-context "$CONTEXT"
+
+# Check cluster info
+echo "📋 Cluster info:"
+kubectl cluster-info
+
+# Check nodes
+echo "🖥️  Cluster nodes:"
+kubectl get nodes
+
+# Check system pods
+echo "🐳 System pods:"
+kubectl get pods -n kube-system
+
+# Check namespaces
+echo "📁 Namespaces:"
+kubectl get namespaces
+
+# Validate RBAC (if you have permissions)
+echo "🔐 Checking RBAC..."
+kubectl auth can-i --list || echo "⚠️  RBAC check requires additional permissions"
+
+echo "✅ Kubernetes cluster validation complete for: ${CONTEXT}"

package/packages/plugin-cloud/scripts/examples/terraform-init.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+# Terraform initialization and validation example
+# Usage: ./terraform-init.sh [environment]
+
+set -euo pipefail
+
+ENVIRONMENT="${1:-staging}"
+
+echo "🚀 Initializing Terraform for ${ENVIRONMENT} environment..."
+
+# Initialize Terraform
+terraform init -backend-config="env/${ENVIRONMENT}/backend.tf"
+
+# Validate configuration
+terraform validate
+
+# Format check
+terraform fmt -check -recursive
+
+# Security scan (if tfsec is installed)
+if command -v tfsec &> /dev/null; then
+    echo "🔒 Running security scan..."
+    tfsec .
+fi
+
+echo "✅ Terraform initialization complete for ${ENVIRONMENT}"

package/packages/plugin-core/README.md

@@ -0,0 +1,274 @@
+# @claudeautopm/plugin-core
+
+> Core framework functionality for ClaudeAutoPM
+
+**Version:** 2.0.0
+**Category:** Core Framework
+**Size:** ~8 KB (gzipped)
+**Status:** ✅ Required (always installed)
+
+---
+
+## Overview
+
+This is the **core framework plugin** that provides essential functionality for ClaudeAutoPM. It includes universal agents, rules, hooks, and utilities that apply to ALL projects regardless of technology stack.
+
+**This plugin is REQUIRED** and is automatically installed with ClaudeAutoPM.
+
+---
+
+## What's Included
+
+### 🤖 Agents (4)
+
+Core agents for framework functionality:
+
+1. **agent-manager** - Create, analyze, and manage agents in the registry
+2. **code-analyzer** - Analyze code changes for bugs, trace logic flow, investigate issues
+3. **test-runner** - Run tests and provide comprehensive analysis of results
+4. **file-analyzer** - Analyze and summarize large files to reduce context usage
+
+### 📋 Commands (3)
+
+Framework utility commands:
+
+1. **code-rabbit** - Process CodeRabbit review comments with context-aware discretion
+2. **prompt** - Handle complex prompts with many @ references
+3. **re-init** - Reinitialize CLAUDE.md with framework rules
+
+### 📜 Rules (23)
+
+Universal rules that apply to all projects:
+
+**Critical Priority:**
+- `tdd.enforcement` - Enforce Test-Driven Development (Red-Green-Refactor)
+- `context7-enforcement` - Enforce Context7 documentation queries
+- `framework-path-rules` - Path convention enforcement
+- `golden-rules` - Core framework principles
+- `security-checklist` - Universal security standards
+
+**High Priority:**
+- `agent-coordination` - Agent orchestration patterns
+- `agent-mandatory` - Agent usage requirements
+- `command-pipelines` - Command orchestration
+- `development-workflow` - Universal development workflow
+- `git-strategy` - Git workflow and branching
+- `definition-of-done` - Quality standards
+- `pipeline-mandatory` - Pipeline enforcement
+
+**Medium Priority:**
+- `ai-integration-patterns` - AI integration best practices
+- `context-optimization` - Context management strategies
+- `development-environments` - Environment setup
+- `naming-conventions` - Naming standards
+- `no-pr-workflow` - Alternative git workflow
+- `performance-guidelines` - Performance optimization
+- `standard-patterns` - Universal coding patterns
+
+**Low Priority:**
+- `datetime` - Date/time handling conventions
+- `frontmatter-operations` - Frontmatter parsing
+- `strip-frontmatter` - Frontmatter utilities
+- `use-ast-grep` - AST parsing utilities
+
+### 🪝 Hooks (7)
+
+Enforcement hooks for framework behavior:
+
+**Context7 Enforcement:**
+- `pre-command-context7.js` - Enforce Context7 queries before command execution (BLOCKING)
+- `pre-agent-context7.js` - Enforce Context7 queries before agent invocation (BLOCKING)
+- `unified-context7-enforcement.sh` - Unified Context7 wrapper
+- `context7-reminder.md` - Context7 reminder text
+
+**Agent Enforcement:**
+- `enforce-agents.js` + `.sh` - Enforce agent usage over direct tool calls (BLOCKING)
+- `strict-enforce-agents.sh` - Stricter agent enforcement (BLOCKING)
+
+**Testing:**
+- `test-hook.sh` - Hook testing utility
+
+### 📦 Scripts (10)
+
+Framework utilities and libraries:
+
+**lib/ - Shared Libraries (5 scripts):**
+- `datetime-utils.sh` - Date and time utilities
+- `frontmatter-utils.sh` - Markdown frontmatter parsing
+- `github-utils.sh` - GitHub API utilities
+- `logging-utils.sh` - Logging utilities
+- `validation-utils.sh` - Validation utilities
+
+**mcp/ - MCP Management (5 scripts):**
+- `add.sh` - Add MCP server
+- `enable.sh` - Enable MCP server
+- `disable.sh` - Disable MCP server
+- `list.sh` - List MCP servers
+- `sync.sh` - Sync MCP configuration
+
+---
+
+## Installation
+
+This plugin is **automatically installed** with ClaudeAutoPM. No manual installation needed.
+
+```bash
+# When you install ClaudeAutoPM:
+npm install -g claudeautopm
+autopm init
+
+# plugin-core is automatically included
+```
+
+---
+
+## Features
+
+### TDD Enforcement ✅
+
+**Always enabled** - Enforces Test-Driven Development:
+- Red-Green-Refactor cycle mandatory
+- Tests MUST be written before implementation
+- 100% test coverage for new code
+- Zero tolerance policy
+
+```bash
+# Enforced by: rules/tdd.enforcement.md
+```
+
+### Context7 Enforcement ✅
+
+**Always enabled** - Enforces Context7 documentation queries:
+- MUST query Context7 before ALL command/agent execution
+- Live documentation verification
+- API signature validation
+- Zero tolerance policy
+
+```bash
+# Enforced by:
+# - rules/context7-enforcement.md
+# - hooks/pre-command-context7.js
+# - hooks/pre-agent-context7.js
+```
+
+### Agent Coordination ✅
+
+**Always enabled** - Agent orchestration and coordination:
+- Agent selection patterns
+- Parallel vs sequential execution
+- Error handling in agent workflows
+- Context management between agents
+
+```bash
+# Enforced by: rules/agent-coordination.md
+```
+
+### MCP Management ✅
+
+**Always enabled** - MCP server management utilities:
+- Add/enable/disable MCP servers
+- List configured servers
+- Sync MCP configuration
+
+```bash
+# Provided by: scripts/mcp/*.sh
+```
+
+---
+
+## Usage
+
+### Using Core Agents
+
+```bash
+# Invoke agents directly
+@agent-manager create a new specialized agent for GraphQL
+@code-analyzer review recent changes for bugs
+@test-runner execute full test suite with analysis
+@file-analyzer summarize large-log-file.log
+```
+
+### Using Core Commands
+
+```bash
+# Process CodeRabbit reviews
+/code-rabbit
+
+# Handle complex prompts
+/prompt
+
+# Reinitialize framework
+/re-init
+```
+
+### Using Scripts
+
+```bash
+# Use utility libraries (sourced by other scripts)
+source .claude/scripts/lib/github-utils.sh
+source .claude/scripts/lib/logging-utils.sh
+
+# MCP management
+bash .claude/scripts/mcp/add.sh context7
+bash .claude/scripts/mcp/list.sh
+bash .claude/scripts/mcp/sync.sh
+```
+
+---
+
+## Dependencies
+
+### Peer Dependencies
+
+None - this is the base plugin.
+
+### Required By
+
+All other plugins depend on `plugin-core`:
+- `@claudeautopm/plugin-pm` - PM workflows
+- `@claudeautopm/plugin-devops` - DevOps automation
+- `@claudeautopm/plugin-cloud` - Cloud infrastructure
+- `@claudeautopm/plugin-frameworks` - Frontend frameworks
+- `@claudeautopm/plugin-databases` - Databases
+- `@claudeautopm/plugin-languages` - Programming languages
+- `@claudeautopm/plugin-data` - Data engineering
+
+---
+
+## Configuration
+
+No configuration needed - all core features are always enabled.
+
+---
+
+## Size and Performance
+
+- **Package size:** ~8 KB (gzipped) / ~80 KB (uncompressed)
+- **Installation time:** < 1 second
+- **Memory footprint:** Minimal (utilities loaded on-demand)
+
+---
+
+## Compatibility
+
+- **Minimum ClaudeAutoPM version:** 3.0.0
+- **Node.js:** >= 18.0.0
+- **Platform:** Cross-platform (macOS, Linux, Windows)
+
+---
+
+## License
+
+MIT
+
+---
+
+## Support
+
+- **Issues:** https://github.com/rafeekpro/ClaudeAutoPM/issues
+- **Documentation:** https://github.com/rafeekpro/ClaudeAutoPM#readme
+- **Changelog:** See [CHANGELOG.md](../../CHANGELOG.md)
+
+---
+
+**Part of ClaudeAutoPM v3.0.0 Plugin Architecture**