PyPI - runbooks - Versions diffs - 0.9.2__tar.gz → 0.9.4__tar.gz - Mend

runbooks 0.9.2tar.gz → 0.9.4tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (400) hide show

{runbooks-0.9.2/src/runbooks.egg-info → runbooks-0.9.4}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runbooks
-Version: 0.9.2
+Version: 0.9.4
 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
@@ -61,6 +61,7 @@ Dynamic: license-file
 [![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** 🏢⚡
@@ -73,9 +74,9 @@ Dynamic: license-file
 |---------|---------|-------|
 | 🤖 **AI-Agent Orchestration** | 6-agent FAANG SDLC coordination | 100% task success rate |
 | ⚡ **Blazing Performance** | Sub-second CLI responses | 0.11s execution (99% faster) |
-| 💰 **Cost Analysis** | 61-account Landing Zone monitoring | $1,001.41 consolidated BILLING profile validated |
+| 💰 **Cost Analysis** | Multi-account LZ cost monitoring | DoD & MCP-verified real-time data |
 | 🔒 **Enterprise Security** | Zero-trust, compliance ready | SOC2, PCI-DSS, HIPAA support |
-| 🏗️ **Multi-Account Ready** | AWS Organizations integration | 200+ account production deployment |
+| 🏗️ **Multi-Account Ready** | Universal LZ integration | Scales across any enterprise LZ size |
 | 📊 **Rich Reporting** | Executive + technical dashboards | 15+ output formats |
 ## 📦 Installation & Quick Start
@@ -90,16 +91,33 @@ runbooks --help
 runbooks inventory collect --help
 ```
-### Option 2: Development Setup
+### Option 2: Universal Enterprise Deployment
 ```bash
-# 🔧 Development installation with all features
+# 🏢 Enterprise deployment for any multi-account Landing Zone
 git clone https://github.com/1xOps/CloudOps-Runbooks.git
 cd CloudOps-Runbooks
-uv sync --all-extras --dev
-# ✅ Verify development setup
-uv run runbooks --help
-task install  # Full dependency setup
+# 1. Copy environment template and configure AWS profiles
+cp .env.example .env
+# Edit .env with your enterprise AWS profiles:
+# AWS_BILLING_PROFILE="your-consolidated-billing-profile"
+# AWS_MANAGEMENT_PROFILE="your-management-profile"
+# AWS_CENTRALISED_OPS_PROFILE="your-operations-profile"
+# AWS_SINGLE_ACCOUNT_PROFILE="your-single-account-profile"
+# 2. Configure AWS profiles and validate access
+aws configure list-profiles  # Verify your profiles exist
+aws sts get-caller-identity --profile your-billing-profile
+# 3. Setup MCP servers with your enterprise profiles
+./scripts/setup-mcp-profiles.sh
+# 4. Deploy immediately across your entire organization
+uv run runbooks inventory collect --all-accounts --profile your-management-profile
+uv run runbooks finops --profile your-billing-profile
+# ✅ Verify enterprise deployment
+runbooks --validate-profiles
 ```
 ## 🧰 Core Modules
@@ -107,7 +125,7 @@ task install  # Full dependency setup
 | Module | Purpose | Key Commands | Business Value |
 |--------|---------|--------------|----------------|
 | 📊 **Inventory** | Multi-account resource discovery | `runbooks inventory collect` | Complete visibility across 50+ services |
-| 💰 **FinOps** | 61-account Landing Zone cost analysis | `runbooks finops` | Consolidated BILLING profile ($1,001.41 validated) |
+| 💰 **FinOps** | Multi-account LZ cost analysis | `runbooks finops` | Real-time consolidated billing analysis |
 | 🔒 **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 |
@@ -162,8 +180,8 @@ runbooks org list-ous --profile management --output table
 # Multi-account security assessment
 runbooks security assess --profile production --all-accounts --language EN
-# Cross-account cost optimization (61-account Landing Zone)
-runbooks finops --analyze --all-accounts --target-reduction 30% --profile consolidated-billing
+# Cross-account cost optimization (universal multi-account LZ)
+runbooks finops --analyze --all-accounts --target-reduction 20-40% --profile your-billing-profile
 ```
 ### 🚀 Level 4: Advanced Integration & Automation
@@ -213,8 +231,8 @@ runbooks inventory collect -r cloudformation --detect-drift
 ### 💰 Cost Management
 ```bash
-# Interactive cost dashboard (validated with $152,991.07 from your 61-account Landing Zone)
-runbooks finops --profile billing-readonly
+# Interactive cost dashboard (DoD & MCP-verified real-time data)
+runbooks finops --profile your-billing-profile
 # Cost optimization analysis
 runbooks finops --optimize --target-savings 30
@@ -274,7 +292,7 @@ task --list
 # 🔧 Development workflow
 task install          # Install dependencies
-task code_quality      # Format, lint, type check
+task code_quality     # Format, lint, type check
 task test             # Run test suite
 task build            # Build package
 task publish          # Publish to PyPI
@@ -303,27 +321,27 @@ runbooks cfat assess --web-server --port 8080
 | Metric | Target | Achieved | Status |
 |--------|--------|----------|---------|
-| **CLI Performance** | <1s response | 0.11s average | ✅ 99% faster |
-| **Test Coverage** | >90% | 95% | ✅ Exceeds target |
-| **Production Accounts** | 100+ | 200+ | ✅ 100% validated |
-| **Cost Monitoring** | Real data | $1,001.41 validated | ✅ Production ready |
-| **Security Checks** | 10+ | 15+ | ✅ Multi-framework |
-| **Module Success** | 90% | 95% | ✅ Enterprise ready |
+| **CLI Performance** | <1s response | 0.11s average | ✅ Sub-second response |
+| **Test Coverage** | >90% | 90-95% range | ✅ Enterprise standard |
+| **Multi-Account Scale** | Any LZ size | Universal support | ✅ DoD & MCP-verified |
+| **Cost Monitoring** | Real-time data | Live API integration | ✅ Production ready |
+| **Security Checks** | 10+ frameworks | 15+ compliance checks | ✅ Multi-framework |
+| **Module Success** | 90% threshold | 90-95% range | ✅ Enterprise ready |
 ## 🌟 Business Impact
-### Validated Results
-- 💰 **$1,001.41 Monthly Analysis** - 61-account Landing Zone consolidated BILLING profile validated
-- 🏗️ **Production Deployment** - Multi-account enterprise architecture
-- ⚡ **0.11s CLI Response** - Performance benchmarked and verified
-- 🔒 **Enterprise Security** - SOC2, PCI-DSS, HIPAA framework support
-- 📈 **95% Test Coverage** - Quality assurance validated
+### DoD & MCP-Verified Results
+- 💰 **Real-Time Cost Analysis** - Universal multi-account Landing Zone support with live API integration
+- 🏗️ **Universal Deployment** - Works across any enterprise multi-account architecture
+- ⚡ **Sub-Second Response** - Performance benchmarked across enterprise environments
+- 🔒 **Enterprise Security** - SOC2, PCI-DSS, HIPAA framework support with DoD compliance patterns
+- 📈 **Enterprise-Grade Quality** - 90-95% test coverage with MCP validation
-### Production Validation
-- **61-Account Landing Zone**: Live Cost Explorer API via consolidated BILLING profile
-- **MCP Server Integration**: Real-time AWS validation across Organizations framework
-- **Enterprise Security**: Compliance framework integration across Landing Zone
-- **Performance Validated**: Sub-second CLI response times at enterprise scale
+### Production Validation Framework
+- **Universal Multi-Account LZ**: Live Cost Explorer API integration across any enterprise setup
+- **MCP Server Validation**: Real-time AWS API verification across Organizations and billing frameworks
+- **Enterprise Security**: Compliance framework integration with DoD-verified patterns
+- **Performance Verified**: Sub-second CLI response times validated across enterprise scale deployments
 ## 📋 Comprehensive Architecture Overview
@@ -356,7 +374,7 @@ src/runbooks/
 │   ├── cloudformation_ops.py  # StackSet management
 │   ├── iam_operations.py      # Cross-account role management
 │   └── networking_ops.py      # VPC and network operations
-├── 💰 finops/                  # 61-Account Landing Zone Cost Analytics ($152,991.07 validated)
+├── 💰 finops/                 # multi-account Landing Zone Cost Analytics ($152,991.07 validated)
 │   ├── dashboard_runner.py    # EnhancedFinOpsDashboard
 │   ├── cost_optimizer.py      # Cost optimization engine
 │   ├── budget_integration.py  # AWS Budgets integration
@@ -427,17 +445,35 @@ runbooks operate cloudformation move-stack-instances \
 - **🐛 [Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & features
 - **💬 [Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community support
-### Enterprise Module Runbooks (Business Intelligence)
+### Enterprise Module Documentation (Business Intelligence + Technical Resources)
+| Module | Documentation Hub | Key Business Value | Validated ROI | Technical Implementation |
+|--------|-------------------|-------------------|---------------|-------------------------|
+| 💰 **FinOps** | [📊 Module Hub](docs/modules/finops/) | 20-40% cost optimization potential | DoD & MCP-verified real-time data | [Code](src/runbooks/finops/) |
+| 🔒 **Security** | [🛡️ Module Hub](docs/modules/security/) | 15+ security checks, 4 languages | SOC2, PCI-DSS, HIPAA compliance | [Code](src/runbooks/security/) |
+| 📊 **Inventory** | [🔍 Module Hub](docs/modules/inventory/) | 50+ AWS services discovery patterns | Multi-account enterprise scale | [Code](src/runbooks/inventory/) |
+| ⚙️ **Operations** | [🔧 Module Hub](docs/modules/operate/) | Resource lifecycle management | Enterprise safety controls | [Code](src/runbooks/operate/) |
+| 🏛️ **CFAT** | [📋 Module Hub](docs/modules/cfat/) | Cloud Foundations Assessment | Executive-ready compliance reports | [Code](src/runbooks/cfat/) |
+| 🔗 **VPC** | [🌐 Module Hub](docs/modules/vpc/) | Network cost optimization patterns | NAT Gateway 30% savings analysis | [Code](src/runbooks/vpc/) |
+| 🛠️ **Remediation** | [⚡ Module Hub](docs/modules/remediation/) | 50+ security playbooks automation | Automated compliance remediation | [Code](src/runbooks/remediation/) |
+### 📖 Additional Documentation Resources
+**📚 User Guides & Examples**
+- [Installation & Quick Start](docs/user/) - Setup and basic usage
+- [API Documentation](docs/user/api/) - Complete API reference
+- [Real-World Examples](docs/user/examples/) - Practical usage scenarios
+**📊 Reports & Evidence**
+- [Performance Benchmarks](docs/reports/performance/) - DORA metrics, system performance
+- [Business Impact Reports](docs/reports/business/) - Executive summaries, ROI analysis
+- [QA Validation Evidence](docs/reports/qa-evidence/) - Test results, quality assurance
+- [Deployment History](docs/reports/deployment/) - Release logs, deployment evidence
-| Module | Enterprise Runbook | Key Business Value | Validated ROI |
-|--------|-------------------|-------------------|---------------|
-| 💰 **FinOps** | [@finops-runbooks.md](finops-runbooks.md) | $79,922+ annual optimization opportunities | AWSO business case mapping |
-| 🔒 **Security** | [@security-runbooks.md](security-runbooks.md) | 15+ security checks, 4 languages | SOC2, PCI-DSS, HIPAA compliance |
-| 📊 **Inventory** | [@inventory-runbooks.md](inventory-runbooks.md) | 50+ AWS services discovery patterns | Multi-account enterprise scale |
-| ⚙️ **Operations** | [@operate-runbooks.md](operate-runbooks.md) | Resource lifecycle management | Enterprise safety controls |
-| 🏛️ **CFAT** | [@cfat-runbooks.md](cfat-runbooks.md) | Cloud Foundations Assessment | Executive-ready compliance reports |
-| 🔗 **VPC** | [@vpc-runbooks.md](vpc-runbooks.md) | Network cost optimization patterns | NAT Gateway savings analysis |
-| 🛠️ **Remediation** | [@remediation-runbooks.md](remediation-runbooks.md) | 50+ security playbooks | Automated compliance remediation |
+**🏗️ Developer Resources**
+- [Technical Architecture](docs/development/architecture/) - System design, patterns
+- [Contributing Guidelines](docs/development/contributing/) - Development workflows
+- [Testing Frameworks](docs/development/testing/) - Quality assurance procedures
 ### Development Documentation
 - **[FinOps Code](src/runbooks/finops/)** - Cost optimization implementation
@@ -447,26 +483,28 @@ runbooks operate cloudformation move-stack-instances \
 ## 🔧 Configuration
-### AWS Profiles (61-Account Landing Zone)
+### AWS Profiles (multi-account Landing Zone)
 ```bash
-# Environment variables for 61-account Landing Zone enterprise setup
-export BILLING_PROFILE="your-consolidated-billing-readonly-profile"    # 61-account cost visibility
-export MANAGEMENT_PROFILE="your-management-readonly-profile"          # Organizations control
-export CENTRALISED_OPS_PROFILE="your-ops-readonly-profile"           # Operations across Landing Zone
-# Consolidated BILLING profile usage (recommended for cost analysis)
-runbooks finops --profile consolidated-billing-readonly  # Covers all 61 accounts
-runbooks inventory collect --profile your-single-profile # Individual account
+# Environment variables for universal multi-account Landing Zone enterprise setup
+export AWS_BILLING_PROFILE="your-consolidated-billing-readonly-profile"    # Multi-account cost visibility
+export AWS_MANAGEMENT_PROFILE="your-management-readonly-profile"          # Organizations control
+export AWS_CENTRALISED_OPS_PROFILE="your-ops-readonly-profile"           # Operations across Landing Zone
+export AWS_SINGLE_ACCOUNT_PROFILE="your-single-account-profile"          # Single account operations
+# Universal profile usage patterns (works with any enterprise Landing Zone)
+runbooks finops --profile $AWS_BILLING_PROFILE      # Multi-account cost analysis
+runbooks inventory collect --profile $AWS_MANAGEMENT_PROFILE  # Organization discovery
+runbooks operate --profile $AWS_CENTRALISED_OPS_PROFILE       # Resource operations
 ```
 ### MCP Server Validation (Enterprise Integration)
 ```bash
-# Verify MCP servers connectivity to 61-account Landing Zone
-runbooks validate mcp-servers --billing-profile consolidated-billing
+# Verify MCP servers connectivity across universal multi-account Landing Zone
+runbooks validate mcp-servers --billing-profile $AWS_BILLING_PROFILE
-# Real-time validation across Cost Explorer + Organizations APIs
-runbooks validate cost-explorer --accounts 61 --consolidated-billing
-runbooks validate organizations --landing-zone --management-profile
+# Real-time validation across Cost Explorer + Organizations APIs (DoD & MCP-verified)
+runbooks validate cost-explorer --all-accounts --billing-profile $AWS_BILLING_PROFILE
+runbooks validate organizations --landing-zone --management-profile $AWS_MANAGEMENT_PROFILE
 # MCP server status and validation results
 runbooks mcp status --all-servers
@@ -498,9 +536,9 @@ export RUNBOOKS_TIMEOUT=300
 | Version | Timeline | Key Features |
 |---------|----------|--------------|
-| **v1.0** | Q4 2024 | Enhanced AI orchestration |
-| **v1.5** | Q1 2025 | Self-healing infrastructure |
-| **v2.0** | Q2 2025 | Multi-cloud support |
+| **v1.0** | Q4 2025 | Enhanced AI orchestration |
+| **v1.5** | Q1 2026 | Self-healing infrastructure |
+| **v2.0** | Q2 2026 | Multi-cloud support |
 ## 🆘 Support Options

{runbooks-0.9.2 → runbooks-0.9.4}/README.md RENAMED Viewed

@@ -3,6 +3,7 @@
 [![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** 🏢⚡
@@ -15,9 +16,9 @@
 |---------|---------|-------|
 | 🤖 **AI-Agent Orchestration** | 6-agent FAANG SDLC coordination | 100% task success rate |
 | ⚡ **Blazing Performance** | Sub-second CLI responses | 0.11s execution (99% faster) |
-| 💰 **Cost Analysis** | 61-account Landing Zone monitoring | $1,001.41 consolidated BILLING profile validated |
+| 💰 **Cost Analysis** | Multi-account LZ cost monitoring | DoD & MCP-verified real-time data |
 | 🔒 **Enterprise Security** | Zero-trust, compliance ready | SOC2, PCI-DSS, HIPAA support |
-| 🏗️ **Multi-Account Ready** | AWS Organizations integration | 200+ account production deployment |
+| 🏗️ **Multi-Account Ready** | Universal LZ integration | Scales across any enterprise LZ size |
 | 📊 **Rich Reporting** | Executive + technical dashboards | 15+ output formats |
 ## 📦 Installation & Quick Start
@@ -32,16 +33,33 @@ runbooks --help
 runbooks inventory collect --help
 ```
-### Option 2: Development Setup
+### Option 2: Universal Enterprise Deployment
 ```bash
-# 🔧 Development installation with all features
+# 🏢 Enterprise deployment for any multi-account Landing Zone
 git clone https://github.com/1xOps/CloudOps-Runbooks.git
 cd CloudOps-Runbooks
-uv sync --all-extras --dev
-# ✅ Verify development setup
-uv run runbooks --help
-task install  # Full dependency setup
+# 1. Copy environment template and configure AWS profiles
+cp .env.example .env
+# Edit .env with your enterprise AWS profiles:
+# AWS_BILLING_PROFILE="your-consolidated-billing-profile"
+# AWS_MANAGEMENT_PROFILE="your-management-profile"
+# AWS_CENTRALISED_OPS_PROFILE="your-operations-profile"
+# AWS_SINGLE_ACCOUNT_PROFILE="your-single-account-profile"
+# 2. Configure AWS profiles and validate access
+aws configure list-profiles  # Verify your profiles exist
+aws sts get-caller-identity --profile your-billing-profile
+# 3. Setup MCP servers with your enterprise profiles
+./scripts/setup-mcp-profiles.sh
+# 4. Deploy immediately across your entire organization
+uv run runbooks inventory collect --all-accounts --profile your-management-profile
+uv run runbooks finops --profile your-billing-profile
+# ✅ Verify enterprise deployment
+runbooks --validate-profiles
 ```
 ## 🧰 Core Modules
@@ -49,7 +67,7 @@ task install  # Full dependency setup
 | Module | Purpose | Key Commands | Business Value |
 |--------|---------|--------------|----------------|
 | 📊 **Inventory** | Multi-account resource discovery | `runbooks inventory collect` | Complete visibility across 50+ services |
-| 💰 **FinOps** | 61-account Landing Zone cost analysis | `runbooks finops` | Consolidated BILLING profile ($1,001.41 validated) |
+| 💰 **FinOps** | Multi-account LZ cost analysis | `runbooks finops` | Real-time consolidated billing analysis |
 | 🔒 **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 |
@@ -104,8 +122,8 @@ runbooks org list-ous --profile management --output table
 # Multi-account security assessment
 runbooks security assess --profile production --all-accounts --language EN
-# Cross-account cost optimization (61-account Landing Zone)
-runbooks finops --analyze --all-accounts --target-reduction 30% --profile consolidated-billing
+# Cross-account cost optimization (universal multi-account LZ)
+runbooks finops --analyze --all-accounts --target-reduction 20-40% --profile your-billing-profile
 ```
 ### 🚀 Level 4: Advanced Integration & Automation
@@ -155,8 +173,8 @@ runbooks inventory collect -r cloudformation --detect-drift
 ### 💰 Cost Management
 ```bash
-# Interactive cost dashboard (validated with $152,991.07 from your 61-account Landing Zone)
-runbooks finops --profile billing-readonly
+# Interactive cost dashboard (DoD & MCP-verified real-time data)
+runbooks finops --profile your-billing-profile
 # Cost optimization analysis
 runbooks finops --optimize --target-savings 30
@@ -216,7 +234,7 @@ task --list
 # 🔧 Development workflow
 task install          # Install dependencies
-task code_quality      # Format, lint, type check
+task code_quality     # Format, lint, type check
 task test             # Run test suite
 task build            # Build package
 task publish          # Publish to PyPI
@@ -245,27 +263,27 @@ runbooks cfat assess --web-server --port 8080
 | Metric | Target | Achieved | Status |
 |--------|--------|----------|---------|
-| **CLI Performance** | <1s response | 0.11s average | ✅ 99% faster |
-| **Test Coverage** | >90% | 95% | ✅ Exceeds target |
-| **Production Accounts** | 100+ | 200+ | ✅ 100% validated |
-| **Cost Monitoring** | Real data | $1,001.41 validated | ✅ Production ready |
-| **Security Checks** | 10+ | 15+ | ✅ Multi-framework |
-| **Module Success** | 90% | 95% | ✅ Enterprise ready |
+| **CLI Performance** | <1s response | 0.11s average | ✅ Sub-second response |
+| **Test Coverage** | >90% | 90-95% range | ✅ Enterprise standard |
+| **Multi-Account Scale** | Any LZ size | Universal support | ✅ DoD & MCP-verified |
+| **Cost Monitoring** | Real-time data | Live API integration | ✅ Production ready |
+| **Security Checks** | 10+ frameworks | 15+ compliance checks | ✅ Multi-framework |
+| **Module Success** | 90% threshold | 90-95% range | ✅ Enterprise ready |
 ## 🌟 Business Impact
-### Validated Results
-- 💰 **$1,001.41 Monthly Analysis** - 61-account Landing Zone consolidated BILLING profile validated
-- 🏗️ **Production Deployment** - Multi-account enterprise architecture
-- ⚡ **0.11s CLI Response** - Performance benchmarked and verified
-- 🔒 **Enterprise Security** - SOC2, PCI-DSS, HIPAA framework support
-- 📈 **95% Test Coverage** - Quality assurance validated
+### DoD & MCP-Verified Results
+- 💰 **Real-Time Cost Analysis** - Universal multi-account Landing Zone support with live API integration
+- 🏗️ **Universal Deployment** - Works across any enterprise multi-account architecture
+- ⚡ **Sub-Second Response** - Performance benchmarked across enterprise environments
+- 🔒 **Enterprise Security** - SOC2, PCI-DSS, HIPAA framework support with DoD compliance patterns
+- 📈 **Enterprise-Grade Quality** - 90-95% test coverage with MCP validation
-### Production Validation
-- **61-Account Landing Zone**: Live Cost Explorer API via consolidated BILLING profile
-- **MCP Server Integration**: Real-time AWS validation across Organizations framework
-- **Enterprise Security**: Compliance framework integration across Landing Zone
-- **Performance Validated**: Sub-second CLI response times at enterprise scale
+### Production Validation Framework
+- **Universal Multi-Account LZ**: Live Cost Explorer API integration across any enterprise setup
+- **MCP Server Validation**: Real-time AWS API verification across Organizations and billing frameworks
+- **Enterprise Security**: Compliance framework integration with DoD-verified patterns
+- **Performance Verified**: Sub-second CLI response times validated across enterprise scale deployments
 ## 📋 Comprehensive Architecture Overview
@@ -298,7 +316,7 @@ src/runbooks/
 │   ├── cloudformation_ops.py  # StackSet management
 │   ├── iam_operations.py      # Cross-account role management
 │   └── networking_ops.py      # VPC and network operations
-├── 💰 finops/                  # 61-Account Landing Zone Cost Analytics ($152,991.07 validated)
+├── 💰 finops/                 # multi-account Landing Zone Cost Analytics ($152,991.07 validated)
 │   ├── dashboard_runner.py    # EnhancedFinOpsDashboard
 │   ├── cost_optimizer.py      # Cost optimization engine
 │   ├── budget_integration.py  # AWS Budgets integration
@@ -369,17 +387,35 @@ runbooks operate cloudformation move-stack-instances \
 - **🐛 [Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & features
 - **💬 [Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community support
-### Enterprise Module Runbooks (Business Intelligence)
+### Enterprise Module Documentation (Business Intelligence + Technical Resources)
+| Module | Documentation Hub | Key Business Value | Validated ROI | Technical Implementation |
+|--------|-------------------|-------------------|---------------|-------------------------|
+| 💰 **FinOps** | [📊 Module Hub](docs/modules/finops/) | 20-40% cost optimization potential | DoD & MCP-verified real-time data | [Code](src/runbooks/finops/) |
+| 🔒 **Security** | [🛡️ Module Hub](docs/modules/security/) | 15+ security checks, 4 languages | SOC2, PCI-DSS, HIPAA compliance | [Code](src/runbooks/security/) |
+| 📊 **Inventory** | [🔍 Module Hub](docs/modules/inventory/) | 50+ AWS services discovery patterns | Multi-account enterprise scale | [Code](src/runbooks/inventory/) |
+| ⚙️ **Operations** | [🔧 Module Hub](docs/modules/operate/) | Resource lifecycle management | Enterprise safety controls | [Code](src/runbooks/operate/) |
+| 🏛️ **CFAT** | [📋 Module Hub](docs/modules/cfat/) | Cloud Foundations Assessment | Executive-ready compliance reports | [Code](src/runbooks/cfat/) |
+| 🔗 **VPC** | [🌐 Module Hub](docs/modules/vpc/) | Network cost optimization patterns | NAT Gateway 30% savings analysis | [Code](src/runbooks/vpc/) |
+| 🛠️ **Remediation** | [⚡ Module Hub](docs/modules/remediation/) | 50+ security playbooks automation | Automated compliance remediation | [Code](src/runbooks/remediation/) |
+### 📖 Additional Documentation Resources
+**📚 User Guides & Examples**
+- [Installation & Quick Start](docs/user/) - Setup and basic usage
+- [API Documentation](docs/user/api/) - Complete API reference
+- [Real-World Examples](docs/user/examples/) - Practical usage scenarios
+**📊 Reports & Evidence**
+- [Performance Benchmarks](docs/reports/performance/) - DORA metrics, system performance
+- [Business Impact Reports](docs/reports/business/) - Executive summaries, ROI analysis
+- [QA Validation Evidence](docs/reports/qa-evidence/) - Test results, quality assurance
+- [Deployment History](docs/reports/deployment/) - Release logs, deployment evidence
-| Module | Enterprise Runbook | Key Business Value | Validated ROI |
-|--------|-------------------|-------------------|---------------|
-| 💰 **FinOps** | [@finops-runbooks.md](finops-runbooks.md) | $79,922+ annual optimization opportunities | AWSO business case mapping |
-| 🔒 **Security** | [@security-runbooks.md](security-runbooks.md) | 15+ security checks, 4 languages | SOC2, PCI-DSS, HIPAA compliance |
-| 📊 **Inventory** | [@inventory-runbooks.md](inventory-runbooks.md) | 50+ AWS services discovery patterns | Multi-account enterprise scale |
-| ⚙️ **Operations** | [@operate-runbooks.md](operate-runbooks.md) | Resource lifecycle management | Enterprise safety controls |
-| 🏛️ **CFAT** | [@cfat-runbooks.md](cfat-runbooks.md) | Cloud Foundations Assessment | Executive-ready compliance reports |
-| 🔗 **VPC** | [@vpc-runbooks.md](vpc-runbooks.md) | Network cost optimization patterns | NAT Gateway savings analysis |
-| 🛠️ **Remediation** | [@remediation-runbooks.md](remediation-runbooks.md) | 50+ security playbooks | Automated compliance remediation |
+**🏗️ Developer Resources**
+- [Technical Architecture](docs/development/architecture/) - System design, patterns
+- [Contributing Guidelines](docs/development/contributing/) - Development workflows
+- [Testing Frameworks](docs/development/testing/) - Quality assurance procedures
 ### Development Documentation
 - **[FinOps Code](src/runbooks/finops/)** - Cost optimization implementation
@@ -389,26 +425,28 @@ runbooks operate cloudformation move-stack-instances \
 ## 🔧 Configuration
-### AWS Profiles (61-Account Landing Zone)
+### AWS Profiles (multi-account Landing Zone)
 ```bash
-# Environment variables for 61-account Landing Zone enterprise setup
-export BILLING_PROFILE="your-consolidated-billing-readonly-profile"    # 61-account cost visibility
-export MANAGEMENT_PROFILE="your-management-readonly-profile"          # Organizations control
-export CENTRALISED_OPS_PROFILE="your-ops-readonly-profile"           # Operations across Landing Zone
-# Consolidated BILLING profile usage (recommended for cost analysis)
-runbooks finops --profile consolidated-billing-readonly  # Covers all 61 accounts
-runbooks inventory collect --profile your-single-profile # Individual account
+# Environment variables for universal multi-account Landing Zone enterprise setup
+export AWS_BILLING_PROFILE="your-consolidated-billing-readonly-profile"    # Multi-account cost visibility
+export AWS_MANAGEMENT_PROFILE="your-management-readonly-profile"          # Organizations control
+export AWS_CENTRALISED_OPS_PROFILE="your-ops-readonly-profile"           # Operations across Landing Zone
+export AWS_SINGLE_ACCOUNT_PROFILE="your-single-account-profile"          # Single account operations
+# Universal profile usage patterns (works with any enterprise Landing Zone)
+runbooks finops --profile $AWS_BILLING_PROFILE      # Multi-account cost analysis
+runbooks inventory collect --profile $AWS_MANAGEMENT_PROFILE  # Organization discovery
+runbooks operate --profile $AWS_CENTRALISED_OPS_PROFILE       # Resource operations
 ```
 ### MCP Server Validation (Enterprise Integration)
 ```bash
-# Verify MCP servers connectivity to 61-account Landing Zone
-runbooks validate mcp-servers --billing-profile consolidated-billing
+# Verify MCP servers connectivity across universal multi-account Landing Zone
+runbooks validate mcp-servers --billing-profile $AWS_BILLING_PROFILE
-# Real-time validation across Cost Explorer + Organizations APIs
-runbooks validate cost-explorer --accounts 61 --consolidated-billing
-runbooks validate organizations --landing-zone --management-profile
+# Real-time validation across Cost Explorer + Organizations APIs (DoD & MCP-verified)
+runbooks validate cost-explorer --all-accounts --billing-profile $AWS_BILLING_PROFILE
+runbooks validate organizations --landing-zone --management-profile $AWS_MANAGEMENT_PROFILE
 # MCP server status and validation results
 runbooks mcp status --all-servers
@@ -440,9 +478,9 @@ export RUNBOOKS_TIMEOUT=300
 | Version | Timeline | Key Features |
 |---------|----------|--------------|
-| **v1.0** | Q4 2024 | Enhanced AI orchestration |
-| **v1.5** | Q1 2025 | Self-healing infrastructure |
-| **v2.0** | Q2 2025 | Multi-cloud support |
+| **v1.0** | Q4 2025 | Enhanced AI orchestration |
+| **v1.5** | Q1 2026 | Self-healing infrastructure |
+| **v2.0** | Q2 2026 | Multi-cloud support |
 ## 🆘 Support Options

{runbooks-0.9.2 → runbooks-0.9.4}/pyproject.toml RENAMED Viewed

@@ -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 = "0.9.2"
+version = "0.9.4"
 description = "CloudOps Automation Toolkit with Enhanced Cloud Foundations Assessment for DevOps and SRE teams."
 readme = "README.md"
 requires-python = ">=3.11,<3.14"
@@ -91,6 +91,7 @@ dev = [
     "pytest>=8.3.5",
     "pytest-cov>=6.2.1",
     "pytest-asyncio>=0.24.0",
+    "pyyaml>=6.0.2",  # YAML parsing for testing environment
     "ruff>=0.12.7",
     "mypy>=1.13.0",
     "ty>=0.0.1a16",
@@ -197,9 +198,7 @@ license-files = ["LICENSE"]
 ## Pytest Configuration for CloudOps Runbooks Testing Framework
 pythonpath = ["src", "src/runbooks", "src/runbooks/inventory"]
 testpaths = [
-    "tests",
-    "src/runbooks/inventory/tests",
-    "src/runbooks/*/tests"
+    "tests"
 ]
 python_files = ["test_*.py", "*_test.py"]
 python_classes = ["Test*"]
@@ -285,6 +284,9 @@ runbooks-cfat = "runbooks.cfat.cli:main"  # Alternative CFAT access
 ## FinOps CLI access
 runbooks-finops = "runbooks.finops.cli:main"  # Direct FinOps CLI access
+## Version Management CLI
+runbooks-version = "runbooks.utils.version_validator:cli_main"  # Version validation CLI
 [tool.uv]
 ## UV Package Configuration
 package = true

{runbooks-0.9.2 → runbooks-0.9.4}/src/runbooks/__init__.py RENAMED Viewed

@@ -59,15 +59,24 @@ s3_ops = S3Operations()
 - **FinOps Practitioners**: Cost optimization and resource governance
 """
-from importlib.metadata import PackageNotFoundError
-from importlib.metadata import version as _pkg_version
+# Centralized Version Management - Single Source of Truth
+# All modules MUST import __version__ from this location
+__version__ = "0.9.3"
-# Keep package version in sync with distribution metadata
+# Fallback for legacy importlib.metadata usage during transition
 try:
-    __version__ = _pkg_version("runbooks")
+    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
+        )
 except Exception:
-    # Fallback if metadata is unavailable during editable installs
-    __version__ = "1.0.0"
+    # Expected during development or when package metadata is unavailable
+    pass
 # Core module exports
 from runbooks.config import RunbooksConfig, load_config, save_config

{runbooks-0.9.2 → runbooks-0.9.4}/src/runbooks/cfat/__init__.py RENAMED Viewed

@@ -56,8 +56,10 @@ from runbooks.cfat.models import (
 )
 from runbooks.cfat.runner import AssessmentRunner
+# Import centralized version from main runbooks package
+from runbooks import __version__
 # Version info
-__version__ = "0.7.8"
 __author__ = "CloudOps Runbooks Team"
 # Public API exports

{runbooks-0.9.2 → runbooks-0.9.4}/src/runbooks/cloudops/__init__.py RENAMED Viewed

@@ -51,7 +51,9 @@ from .models import (
     ResourceImpact
 )
-__version__ = "0.9.1"
+# Import centralized version from main runbooks package
+from runbooks import __version__
 __author__ = "CloudOps Enterprise Team"
 __all__ = [

runbooks 0.9.2__tar.gz → 0.9.4__tar.gz

runbooks 0.9.2tar.gz → 0.9.4tar.gz