runbooks 1.1.4__tar.gz → 1.1.5__tar.gz

runbooks-1.1.5/PKG-INFO

@@ -0,0 +1,328 @@
+Metadata-Version: 2.4
+Name: runbooks
+Version: 1.1.5
+Summary: CloudOps Automation Toolkit with Enhanced Cloud Foundations Assessment for DevOps and SRE teams.
+Author-email: Maintainers <nnthanh101@gmail.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://cloudops.oceansoft.io
+Project-URL: Repository, https://github.com/1xOps/CloudOps-Runbooks
+Project-URL: Documentation, https://cloudops.oceansoft.io/runbooks/
+Project-URL: Issues, https://github.com/1xOps/CloudOps-Runbooks/issues
+Project-URL: Changelog, https://github.com/1xOps/CloudOps-Runbooks/blob/main/CHANGELOG.md
+Keywords: runbooks,automation,DevOps,SRE,CloudOps,AWS,cloud-foundations,FinOps,enterprise,cost-optimization,security-compliance,multi-account,business-intelligence
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3>=1.35.40
+Requires-Dist: botocore>=1.35.40
+Requires-Dist: diagrams>=0.24.4
+Requires-Dist: click>=8.2.1
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: jinja2>=3.1.4
+Requires-Dist: werkzeug>=3.1.0
+Requires-Dist: markdown>=3.7.0
+Requires-Dist: prettytable>=3.16.0
+Requires-Dist: simplejson>=3.20.1
+Requires-Dist: python-dateutil>=2.9.0
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: tqdm>=4.67.1
+Requires-Dist: graphviz>=0.20.1
+Requires-Dist: rich>=14.0.0
+Requires-Dist: reportlab>=3.6.1
+Requires-Dist: requests>=2.32.0
+Requires-Dist: packaging>=21.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: jmespath>=1.0.1
+Requires-Dist: urllib3<1.27,>=1.26.18
+Requires-Dist: mcp>=1.12.3
+Requires-Dist: pandas>=2.3.1
+Requires-Dist: ipython>=9.4.0
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: matplotlib>=3.10.5
+Requires-Dist: seaborn>=0.13.2
+Requires-Dist: plotly>=6.3.0
+Requires-Dist: papermill>=2.6.0
+Requires-Dist: jupyter>=1.1.1
+Requires-Dist: ipywidgets>=8.1.7
+Requires-Dist: pytest>=8.4.1
+Requires-Dist: scipy>=1.16.2
+Dynamic: license-file
+
+# 🚀 CloudOps Runbooks - Enterprise AWS Automation
+
+[![PyPI](https://img.shields.io/pypi/v/runbooks)](https://pypi.org/project/runbooks/)
+[![Python](https://img.shields.io/pypi/pyversions/runbooks)](https://pypi.org/project/runbooks/)
+[![License](https://img.shields.io/pypi/l/runbooks)](https://opensource.org/licenses/Apache-2.0)
+[![Documentation](https://img.shields.io/badge/docs-latest-brightgreen)](https://cloudops.oceansoft.io/runbooks/)
+[![Downloads](https://img.shields.io/pypi/dm/runbooks)](https://pypi.org/project/runbooks/)
+
+> **Enterprise-grade AWS automation toolkit for DevOps and SRE teams managing multi-account cloud environments at scale** 🏢⚡
+
+**Quick Value**: Discover, analyze, and optimize AWS resources across multi-account AWS environments with production-validated automation patterns.
+
+---
+
+## Runbooks FinOps & AWS MCP Servers
+
+> The hybrid approach (Runbooks FinOps & AWS MCPs) leverages the strengths of both solutions: AWS MCPs for real-time accuracy data access and Runbooks FinOps for business intelligence and visualization, ensuring optimal cost optimization results for your enterprise environment.
+
+---
+
+## 🏆 **5-Minute Manager Success Path**
+
+### **Step 1: Installation** (30 seconds)
+```bash
+pip install runbooks
+runbooks --version
+```
+
+### **Step 2: Cost Discovery** (3 minutes)
+```bash
+# Replace with your billing profile
+export AWS_BILLING_PROFILE="your-billing-readonly-profile"
+runbooks finops --dry-run --profile $AWS_BILLING_PROFILE
+
+# Expected output: Cost optimization opportunities across multiple categories
+```
+
+### **Step 3: Executive Reports** (90 seconds)
+```bash
+runbooks finops --export pdf --report-name executive-summary
+runbooks finops --export csv --detailed-analysis
+```
+
+## 🎯 Why CloudOps Runbooks?
+
+| Feature | Benefit | Status |
+|---------|---------|--------|
+| 🤖 **AI-Agents Orchestration** | AI-Agents FAANG SDLC coordination | ✅ Production Ready |
+| ⚡ **Blazing Performance** | Sub-second CLI responses | ✅ 0.11s execution |
+| 💰 **Cost Analysis** | Multi-account cost monitoring | ✅ Real-time analysis |
+| 🔒 **Enterprise Security** | Zero-trust, compliance ready | ✅ SOC2, PCI-DSS, HIPAA |
+| 🏗️ **Multi-Account Ready** | Universal AWS integration | ✅ 200+ accounts supported |
+| 📊 **Rich Reporting** | Executive + technical dashboards | ✅ 15+ output formats |
+
+## 💰 **Strategic Value Framework**
+
+### **Business Impact Matrix**
+```bash
+# Enterprise cost optimization suite
+pip install runbooks
+
+# Business scenario analysis
+runbooks finops --scenario workspaces --dry-run
+runbooks finops --scenario nat-gateway --dry-run
+runbooks finops --scenario elastic-ip --dry-run
+runbooks finops --scenario rds-snapshots --dry-run
+runbooks finops --scenario ebs-volumes --dry-run
+
+# Strategic analysis modes
+runbooks finops --profile $AWS_BILLING_PROFILE            # Cost visibility
+runbooks finops --trend --profile $AWS_BILLING_PROFILE    # Trend analysis
+runbooks finops --audit --profile $AWS_BILLING_PROFILE    # Audit compliance
+```
+
+### **Executive-Ready Deliverables**
+| Scenario | Time to Value | Deliverable |
+|----------|---------------|-------------|
+| 🏢 **WorkSpaces Optimization** | 2 minutes | Executive PDF report |
+| 🌐 **Network Cost Reduction** | 3 minutes | Cost analysis dashboard |
+| 📊 **Storage Efficiency** | 2 minutes | Optimization roadmap |
+| 🎯 **Complete Cost Audit** | 5 minutes | Comprehensive analysis |
+
+## 📦 Installation & Quick Start
+
+### Production Installation
+```bash
+pip install runbooks
+
+# Verify installation
+runbooks --help
+runbooks inventory collect --help
+```
+
+### Configuration
+```bash
+# Set up your AWS profiles
+export AWS_BILLING_PROFILE="your-billing-readonly-profile"
+export AWS_MANAGEMENT_PROFILE="your-management-readonly-profile"
+export AWS_OPERATIONS_PROFILE="your-operations-readonly-profile"
+
+# Test single account access
+runbooks inventory collect --profile $AWS_OPERATIONS_PROFILE --regions us-east-1
+```
+
+## 🧰 Core Modules
+
+| Module | Purpose | Key Commands | Business Value |
+|--------|---------|--------------|----------------|
+| 📊 **Inventory** | Multi-account resource discovery | `runbooks inventory collect` | Complete visibility across 50+ services |
+| 💰 **FinOps** | Multi-account cost analysis | `runbooks finops` | Real-time cost optimization |
+| 🔒 **Security** | Compliance & baseline testing | `runbooks security assess` | 15+ security checks, 4 languages |
+| 🏛️ **CFAT** | Cloud Foundations Assessment | `runbooks cfat assess` | Executive-ready compliance reports |
+| ⚙️ **Operate** | Resource lifecycle management | `runbooks operate ec2 start` | Safe resource operations |
+| 🔗 **VPC** | Network analysis & optimization | `runbooks vpc analyze` | Network cost optimization |
+| 🏢 **Organizations** | OU structure management | `runbooks org setup-ous` | Landing Zone automation |
+| 🛠️ **Remediation** | Automated security fixes | `runbooks remediate` | 50+ security playbooks |
+
+## ⚡ Essential Commands Reference
+
+### 🔍 Discovery & Inventory
+```bash
+# Multi-service resource discovery
+runbooks inventory collect -r ec2,s3,rds --profile production
+
+# Cross-account organization scan
+runbooks scan --all-accounts --include-cost-analysis
+
+# Specialized discovery operations
+runbooks inventory collect -r lambda --include-code-analysis
+```
+
+### 💰 Cost Management
+```bash
+# Interactive cost dashboard
+runbooks finops --profile your-billing-profile
+
+# Cost optimization analysis
+runbooks finops --optimize --target-savings 30
+
+# Multi-account cost aggregation
+runbooks finops --all-accounts --breakdown-by service,account,region
+```
+
+### 🔒 Security & Compliance
+```bash
+# Security baseline assessment
+runbooks security assess --profile production --language EN
+
+# Multi-framework compliance check
+runbooks cfat assess --compliance-framework "AWS Well-Architected"
+
+# Specialized security operations
+runbooks security check root_mfa --profile management
+```
+
+### ⚙️ Resource Operations
+```bash
+# Safe EC2 operations (dry-run by default)
+runbooks operate ec2 stop --instance-ids i-1234567890abcdef0 --dry-run
+
+# S3 security hardening
+runbooks operate s3 set-public-access-block --account-id 123456789012
+
+# CloudFormation operations
+runbooks operate cloudformation move-stack-instances \
+  --source-stackset old-baseline --target-stackset new-baseline --dry-run
+```
+
+## 🏗️ Architecture Highlights
+
+### Modern Stack
+- **🐍 Python 3.11+**: Modern async capabilities
+- **⚡ UV + Ruff**: 10x faster dependency resolution & linting
+- **🎨 Rich CLI**: Beautiful terminal interfaces
+- **📊 Pydantic V2**: Type-safe data models
+- **🔗 boto3**: Native AWS SDK integration
+- **🤖 MCP Servers**: Real-time AWS API access ([MCP Specification](https://modelcontextprotocol.io/))
+
+### Enterprise Features
+- **🔐 Multi-Profile AWS**: Seamless account switching
+- **🌐 Multi-Language Reports**: EN/JP/KR/VN support
+- **📈 DORA Metrics**: DevOps performance tracking
+- **🚨 Safety Controls**: Dry-run defaults, approval workflows
+- **📊 Executive Dashboards**: Business-ready reporting
+
+## 📚 Documentation
+
+### Quick Links
+- **🏠 [Homepage](https://cloudops.oceansoft.io)** - Official project website
+- **📖 [Documentation](https://cloudops.oceansoft.io/runbooks/)** - Complete guides
+- **🐛 [Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & features
+- **💬 [Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community support
+
+### Enterprise Module Documentation
+
+| Module | Documentation Hub | Key Business Value | Technical Implementation |
+|--------|-------------------|-------------------|--------------------------|
+| 💰 **FinOps** | [📊 Module Hub](docs/modules/finops/) | 20-40% cost optimization | [Code](src/runbooks/finops/) |
+| 🔒 **Security** | [🛡️ Module Hub](docs/modules/security/) | 15+ security checks, 4 languages | [Code](src/runbooks/security/) |
+| 📊 **Inventory** | [🔍 Module Hub](docs/modules/inventory/) | 50+ AWS services discovery | [Code](src/runbooks/inventory/) |
+| ⚙️ **Operations** | [🔧 Module Hub](docs/modules/operate/) | Resource lifecycle management | [Code](src/runbooks/operate/) |
+
+## 🔧 Configuration
+
+### AWS Profiles Setup
+```bash
+# Environment variables for enterprise setup
+export AWS_BILLING_PROFILE="your-billing-readonly-profile"
+export AWS_MANAGEMENT_PROFILE="your-management-readonly-profile"
+export AWS_OPERATIONS_PROFILE="your-operations-readonly-profile"
+
+# Universal profile usage patterns
+runbooks finops --profile $AWS_BILLING_PROFILE      # Cost analysis
+runbooks inventory collect --profile $AWS_MANAGEMENT_PROFILE  # Discovery
+runbooks operate --profile $AWS_OPERATIONS_PROFILE   # Operations
+```
+
+### Advanced Configuration
+```bash
+# Custom configuration directory
+export RUNBOOKS_CONFIG_DIR="/path/to/config"
+
+# Performance tuning
+export RUNBOOKS_PARALLEL_WORKERS=10
+export RUNBOOKS_TIMEOUT=300
+```
+
+## 🛡️ Security & Compliance
+
+| Framework | Status | Coverage |
+|-----------|--------|----------|
+| **AWS Well-Architected** | ✅ Full | 5 pillars |
+| **SOC2** | ✅ Compliant | Type II ready |
+| **PCI-DSS** | ✅ Validated | Level 1 |
+| **HIPAA** | ✅ Ready | Healthcare compliant |
+| **ISO 27001** | ✅ Aligned | Security management |
+
+## 🚦 Roadmap
+
+| Version | Timeline | Key Features |
+|---------|----------|--------------|
+| **v1.1.4** | **Current** | ✅ **Enterprise Production** - ProfileManager + Enhanced exports |
+| **v1.2** | Q1 2026 | Enhanced enterprise features and expanded service coverage |
+| **v1.3** | Q2 2026 | Enhanced AI orchestration with universal compatibility |
+| **v1.5** | Q3 2026 | Self-healing infrastructure across any AWS setup |
+| **v2.0** | Q4 2026 | Multi-cloud support (Azure, GCP) |
+
+## 🆘 Support Options
+
+### Community Support (Free)
+- 🐛 **[GitHub Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & feature requests
+- 💬 **[GitHub Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community Q&A
+
+### Enterprise Support
+- 🏢 **Professional Services** - Custom deployment assistance
+- 🎓 **Training Programs** - Team enablement workshops
+- 🛠️ **Custom Development** - Tailored collector modules
+- 📧 **Email**: [info@oceansoft.io](mailto:info@oceansoft.io)
+
+## 📄 License
+
+Apache License 2.0 - See [LICENSE](LICENSE) file for details.
+
+---
+
+**🏗️ Built with ❤️ by the xOps team at OceanSoft**
+
+*Transform your AWS operations from reactive to proactive with enterprise-grade automation* 🚀

runbooks-1.1.5/README.md

@@ -0,0 +1,268 @@
+# 🚀 CloudOps Runbooks - Enterprise AWS Automation
+
+[![PyPI](https://img.shields.io/pypi/v/runbooks)](https://pypi.org/project/runbooks/)
+[![Python](https://img.shields.io/pypi/pyversions/runbooks)](https://pypi.org/project/runbooks/)
+[![License](https://img.shields.io/pypi/l/runbooks)](https://opensource.org/licenses/Apache-2.0)
+[![Documentation](https://img.shields.io/badge/docs-latest-brightgreen)](https://cloudops.oceansoft.io/runbooks/)
+[![Downloads](https://img.shields.io/pypi/dm/runbooks)](https://pypi.org/project/runbooks/)
+
+> **Enterprise-grade AWS automation toolkit for DevOps and SRE teams managing multi-account cloud environments at scale** 🏢⚡
+
+**Quick Value**: Discover, analyze, and optimize AWS resources across multi-account AWS environments with production-validated automation patterns.
+
+---
+
+## Runbooks FinOps & AWS MCP Servers
+
+> The hybrid approach (Runbooks FinOps & AWS MCPs) leverages the strengths of both solutions: AWS MCPs for real-time accuracy data access and Runbooks FinOps for business intelligence and visualization, ensuring optimal cost optimization results for your enterprise environment.
+
+---
+
+## 🏆 **5-Minute Manager Success Path**
+
+### **Step 1: Installation** (30 seconds)
+```bash
+pip install runbooks
+runbooks --version
+```
+
+### **Step 2: Cost Discovery** (3 minutes)
+```bash
+# Replace with your billing profile
+export AWS_BILLING_PROFILE="your-billing-readonly-profile"
+runbooks finops --dry-run --profile $AWS_BILLING_PROFILE
+
+# Expected output: Cost optimization opportunities across multiple categories
+```
+
+### **Step 3: Executive Reports** (90 seconds)
+```bash
+runbooks finops --export pdf --report-name executive-summary
+runbooks finops --export csv --detailed-analysis
+```
+
+## 🎯 Why CloudOps Runbooks?
+
+| Feature | Benefit | Status |
+|---------|---------|--------|
+| 🤖 **AI-Agents Orchestration** | AI-Agents FAANG SDLC coordination | ✅ Production Ready |
+| ⚡ **Blazing Performance** | Sub-second CLI responses | ✅ 0.11s execution |
+| 💰 **Cost Analysis** | Multi-account cost monitoring | ✅ Real-time analysis |
+| 🔒 **Enterprise Security** | Zero-trust, compliance ready | ✅ SOC2, PCI-DSS, HIPAA |
+| 🏗️ **Multi-Account Ready** | Universal AWS integration | ✅ 200+ accounts supported |
+| 📊 **Rich Reporting** | Executive + technical dashboards | ✅ 15+ output formats |
+
+## 💰 **Strategic Value Framework**
+
+### **Business Impact Matrix**
+```bash
+# Enterprise cost optimization suite
+pip install runbooks
+
+# Business scenario analysis
+runbooks finops --scenario workspaces --dry-run
+runbooks finops --scenario nat-gateway --dry-run
+runbooks finops --scenario elastic-ip --dry-run
+runbooks finops --scenario rds-snapshots --dry-run
+runbooks finops --scenario ebs-volumes --dry-run
+
+# Strategic analysis modes
+runbooks finops --profile $AWS_BILLING_PROFILE            # Cost visibility
+runbooks finops --trend --profile $AWS_BILLING_PROFILE    # Trend analysis
+runbooks finops --audit --profile $AWS_BILLING_PROFILE    # Audit compliance
+```
+
+### **Executive-Ready Deliverables**
+| Scenario | Time to Value | Deliverable |
+|----------|---------------|-------------|
+| 🏢 **WorkSpaces Optimization** | 2 minutes | Executive PDF report |
+| 🌐 **Network Cost Reduction** | 3 minutes | Cost analysis dashboard |
+| 📊 **Storage Efficiency** | 2 minutes | Optimization roadmap |
+| 🎯 **Complete Cost Audit** | 5 minutes | Comprehensive analysis |
+
+## 📦 Installation & Quick Start
+
+### Production Installation
+```bash
+pip install runbooks
+
+# Verify installation
+runbooks --help
+runbooks inventory collect --help
+```
+
+### Configuration
+```bash
+# Set up your AWS profiles
+export AWS_BILLING_PROFILE="your-billing-readonly-profile"
+export AWS_MANAGEMENT_PROFILE="your-management-readonly-profile"
+export AWS_OPERATIONS_PROFILE="your-operations-readonly-profile"
+
+# Test single account access
+runbooks inventory collect --profile $AWS_OPERATIONS_PROFILE --regions us-east-1
+```
+
+## 🧰 Core Modules
+
+| Module | Purpose | Key Commands | Business Value |
+|--------|---------|--------------|----------------|
+| 📊 **Inventory** | Multi-account resource discovery | `runbooks inventory collect` | Complete visibility across 50+ services |
+| 💰 **FinOps** | Multi-account cost analysis | `runbooks finops` | Real-time cost optimization |
+| 🔒 **Security** | Compliance & baseline testing | `runbooks security assess` | 15+ security checks, 4 languages |
+| 🏛️ **CFAT** | Cloud Foundations Assessment | `runbooks cfat assess` | Executive-ready compliance reports |
+| ⚙️ **Operate** | Resource lifecycle management | `runbooks operate ec2 start` | Safe resource operations |
+| 🔗 **VPC** | Network analysis & optimization | `runbooks vpc analyze` | Network cost optimization |
+| 🏢 **Organizations** | OU structure management | `runbooks org setup-ous` | Landing Zone automation |
+| 🛠️ **Remediation** | Automated security fixes | `runbooks remediate` | 50+ security playbooks |
+
+## ⚡ Essential Commands Reference
+
+### 🔍 Discovery & Inventory
+```bash
+# Multi-service resource discovery
+runbooks inventory collect -r ec2,s3,rds --profile production
+
+# Cross-account organization scan
+runbooks scan --all-accounts --include-cost-analysis
+
+# Specialized discovery operations
+runbooks inventory collect -r lambda --include-code-analysis
+```
+
+### 💰 Cost Management
+```bash
+# Interactive cost dashboard
+runbooks finops --profile your-billing-profile
+
+# Cost optimization analysis
+runbooks finops --optimize --target-savings 30
+
+# Multi-account cost aggregation
+runbooks finops --all-accounts --breakdown-by service,account,region
+```
+
+### 🔒 Security & Compliance
+```bash
+# Security baseline assessment
+runbooks security assess --profile production --language EN
+
+# Multi-framework compliance check
+runbooks cfat assess --compliance-framework "AWS Well-Architected"
+
+# Specialized security operations
+runbooks security check root_mfa --profile management
+```
+
+### ⚙️ Resource Operations
+```bash
+# Safe EC2 operations (dry-run by default)
+runbooks operate ec2 stop --instance-ids i-1234567890abcdef0 --dry-run
+
+# S3 security hardening
+runbooks operate s3 set-public-access-block --account-id 123456789012
+
+# CloudFormation operations
+runbooks operate cloudformation move-stack-instances \
+  --source-stackset old-baseline --target-stackset new-baseline --dry-run
+```
+
+## 🏗️ Architecture Highlights
+
+### Modern Stack
+- **🐍 Python 3.11+**: Modern async capabilities
+- **⚡ UV + Ruff**: 10x faster dependency resolution & linting
+- **🎨 Rich CLI**: Beautiful terminal interfaces
+- **📊 Pydantic V2**: Type-safe data models
+- **🔗 boto3**: Native AWS SDK integration
+- **🤖 MCP Servers**: Real-time AWS API access ([MCP Specification](https://modelcontextprotocol.io/))
+
+### Enterprise Features
+- **🔐 Multi-Profile AWS**: Seamless account switching
+- **🌐 Multi-Language Reports**: EN/JP/KR/VN support
+- **📈 DORA Metrics**: DevOps performance tracking
+- **🚨 Safety Controls**: Dry-run defaults, approval workflows
+- **📊 Executive Dashboards**: Business-ready reporting
+
+## 📚 Documentation
+
+### Quick Links
+- **🏠 [Homepage](https://cloudops.oceansoft.io)** - Official project website
+- **📖 [Documentation](https://cloudops.oceansoft.io/runbooks/)** - Complete guides
+- **🐛 [Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & features
+- **💬 [Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community support
+
+### Enterprise Module Documentation
+
+| Module | Documentation Hub | Key Business Value | Technical Implementation |
+|--------|-------------------|-------------------|--------------------------|
+| 💰 **FinOps** | [📊 Module Hub](docs/modules/finops/) | 20-40% cost optimization | [Code](src/runbooks/finops/) |
+| 🔒 **Security** | [🛡️ Module Hub](docs/modules/security/) | 15+ security checks, 4 languages | [Code](src/runbooks/security/) |
+| 📊 **Inventory** | [🔍 Module Hub](docs/modules/inventory/) | 50+ AWS services discovery | [Code](src/runbooks/inventory/) |
+| ⚙️ **Operations** | [🔧 Module Hub](docs/modules/operate/) | Resource lifecycle management | [Code](src/runbooks/operate/) |
+
+## 🔧 Configuration
+
+### AWS Profiles Setup
+```bash
+# Environment variables for enterprise setup
+export AWS_BILLING_PROFILE="your-billing-readonly-profile"
+export AWS_MANAGEMENT_PROFILE="your-management-readonly-profile"
+export AWS_OPERATIONS_PROFILE="your-operations-readonly-profile"
+
+# Universal profile usage patterns
+runbooks finops --profile $AWS_BILLING_PROFILE      # Cost analysis
+runbooks inventory collect --profile $AWS_MANAGEMENT_PROFILE  # Discovery
+runbooks operate --profile $AWS_OPERATIONS_PROFILE   # Operations
+```
+
+### Advanced Configuration
+```bash
+# Custom configuration directory
+export RUNBOOKS_CONFIG_DIR="/path/to/config"
+
+# Performance tuning
+export RUNBOOKS_PARALLEL_WORKERS=10
+export RUNBOOKS_TIMEOUT=300
+```
+
+## 🛡️ Security & Compliance
+
+| Framework | Status | Coverage |
+|-----------|--------|----------|
+| **AWS Well-Architected** | ✅ Full | 5 pillars |
+| **SOC2** | ✅ Compliant | Type II ready |
+| **PCI-DSS** | ✅ Validated | Level 1 |
+| **HIPAA** | ✅ Ready | Healthcare compliant |
+| **ISO 27001** | ✅ Aligned | Security management |
+
+## 🚦 Roadmap
+
+| Version | Timeline | Key Features |
+|---------|----------|--------------|
+| **v1.1.4** | **Current** | ✅ **Enterprise Production** - ProfileManager + Enhanced exports |
+| **v1.2** | Q1 2026 | Enhanced enterprise features and expanded service coverage |
+| **v1.3** | Q2 2026 | Enhanced AI orchestration with universal compatibility |
+| **v1.5** | Q3 2026 | Self-healing infrastructure across any AWS setup |
+| **v2.0** | Q4 2026 | Multi-cloud support (Azure, GCP) |
+
+## 🆘 Support Options
+
+### Community Support (Free)
+- 🐛 **[GitHub Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & feature requests
+- 💬 **[GitHub Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community Q&A
+
+### Enterprise Support
+- 🏢 **Professional Services** - Custom deployment assistance
+- 🎓 **Training Programs** - Team enablement workshops
+- 🛠️ **Custom Development** - Tailored collector modules
+- 📧 **Email**: [info@oceansoft.io](mailto:info@oceansoft.io)
+
+## 📄 License
+
+Apache License 2.0 - See [LICENSE](LICENSE) file for details.
+
+---
+
+**🏗️ Built with ❤️ by the xOps team at OceanSoft**
+
+*Transform your AWS operations from reactive to proactive with enterprise-grade automation* 🚀

{runbooks-1.1.4 → runbooks-1.1.5}/pyproject.toml

@@ -13,7 +13,7 @@
 ## Metadata: https://docs.astral.sh/uv/concepts/projects/config/
 name = "runbooks"
 ## Enhanced with AWS Operations integration, unified CLI architecture, and comprehensive service operations
-version = "1.1.4"
+version = "1.1.5"
 description = "CloudOps Automation Toolkit with Enhanced Cloud Foundations Assessment for DevOps and SRE teams."
 readme = "README.md"
 requires-python = ">=3.11,<3.14"
@@ -79,6 +79,7 @@ dependencies = [
     "jupyter>=1.1.1",
     "ipywidgets>=8.1.7",
     "pytest>=8.4.1",
+    "scipy>=1.16.2",
 ]
 
 ##─────────────────────────────────
@@ -165,8 +166,8 @@ analytics = [
     "openpyxl>=3.1.5",
     "pandas>=2.2.3",
     "plotly>=5.24.1",
-    "vizro>=0.1.30",
-    "vizro-ai>=0.3.2",
+    "vizro>=0.1.46",        ## Updated to latest version per PyPI
+    "vizro-ai>=0.3.7",     ## Updated to latest version per PyPI
 ]
 
 [tool.setuptools.package-data]

{runbooks-1.1.4 → runbooks-1.1.5}/src/runbooks/__init__.py

@@ -61,18 +61,20 @@ s3_ops = S3Operations()
 
 # Centralized Version Management - Single Source of Truth
 # All modules MUST import __version__ from this location
-__version__ = "1.1.3"
+__version__ = "1.1.5"
 
 # Fallback for legacy importlib.metadata usage during transition
 try:
     from importlib.metadata import version as _pkg_version
+
     _metadata_version = _pkg_version("runbooks")
     if _metadata_version != __version__:
         import warnings
+
         warnings.warn(
             f"Version mismatch detected: pyproject.toml has {_metadata_version}, "
             f"but centralized version is {__version__}. Please sync pyproject.toml.",
-            UserWarning
+            UserWarning,
         )
 except Exception:
     # Expected during development or when package metadata is unavailable
@@ -118,11 +120,35 @@ except ImportError as e:
 # PERFORMANCE FIX: Lazy load finops to avoid MCP initialization
 # from runbooks.finops import get_cost_data, get_trend, run_dashboard
 
+
 def get_finops_functions():
     """Lazy load finops functions only when needed."""
     from runbooks.finops import get_cost_data, get_trend, run_dashboard
+
     return get_cost_data, get_trend, run_dashboard
 
+
+# Integration exports
+# PERFORMANCE FIX: Lazy load integration to avoid MCP initialization during package import
+def get_integration_functions():
+    """Lazy load integration functions only when needed."""
+    from runbooks.integration import (
+        create_enterprise_mcp_framework,
+        create_mcp_manager_for_multi_account,
+        create_mcp_manager_for_single_account,
+        MCPIntegrationManager,
+        CrossValidationEngine,
+    )
+
+    return {
+        "create_enterprise_mcp_framework": create_enterprise_mcp_framework,
+        "create_mcp_manager_for_multi_account": create_mcp_manager_for_multi_account,
+        "create_mcp_manager_for_single_account": create_mcp_manager_for_single_account,
+        "MCPIntegrationManager": MCPIntegrationManager,
+        "CrossValidationEngine": CrossValidationEngine,
+    }
+
+
 # Consolidated exports for enterprise CloudOps platform
 __all__ = [
     # Core utilities
@@ -136,4 +162,7 @@ __all__ = [
     # FinOps capabilities
     # Lazy loaded finops functions via get_finops_functions()
     "get_finops_functions",
+    # Integration capabilities
+    # Lazy loaded integration functions via get_integration_functions()
+    "get_integration_functions",
 ] + _enterprise_exports