Add PowerShell Gallery publishing support v2.3.0 - Complete automated publishing workflow with validation, testing, and comprehensive documentation

Author: adrian207

AD-Audit.psd1

@@ -3,7 +3,7 @@
     RootModule = 'Run-M&A-Audit.ps1'
 
     # Version number of this module.
-    ModuleVersion = '2.0.0'
+    ModuleVersion = '2.3.0'
 
     # Supported PSEditions
     CompatiblePSEditions = @('Desktop', 'Core')
@@ -22,20 +22,24 @@
 
     # Description of the functionality provided by this module
     Description = @'
-M&A Technical Discovery Audit Tool - Comprehensive PowerShell-based auditing solution for merger and acquisition due diligence.
+M&A Technical Discovery Audit Tool - Comprehensive PowerShell-based auditing solution for merger and acquisition due diligence with advanced analytics and reporting.
 
-Features:
-- Active Directory audit (users, computers, groups, GPOs, trusts, service accounts)
-- Server hardware inventory (CPU, memory, storage, virtualization)
-- SQL Server discovery (instances, databases, backups, logins, jobs)
+Key Features:
+- Active Directory comprehensive audit (9 advanced security components: ACL, Kerberos, DHCP, GPO, DNS, Certs, etc.)
+- Server hardware inventory (CPU, memory, storage, virtualization, applications)
+- SQL Server discovery (instances, databases, backups, logins, jobs, security)
 - Microsoft 365 audit (Entra ID, Exchange, SharePoint, Teams, Power Platform)
 - Compliance audit (DLP, retention, sensitivity labels, eDiscovery)
-- HTML reporting with executive dashboard and migration readiness score
-- SQLite database integration for advanced queries
+- Advanced Analytics Engine (baseline comparison, anomaly detection, risk scoring)
+- Executive Dashboards (beautiful HTML reports with risk gauges and charts)
+- Alert System (email notifications for threshold breaches)
+- Visual Query Builder (web-based with 20+ templates, saved queries, dark mode)
+- SQLite database integration for advanced queries and trend analysis
 - Enterprise encryption (EFS, 7-Zip, Azure Key Vault)
-- Pester testing framework with 110+ tests (~75% coverage)
+- Comprehensive testing (118+ tests, ~78% coverage)
+- CI/CD integration (GitHub Actions, Azure DevOps)
 
-Designed for IT consultants, M&A teams, and technical due diligence professionals.
+Designed for IT consultants, M&A teams, security analysts, and technical due diligence professionals.
 '@
 
     # Minimum version of the PowerShell engine required by this module
@@ -83,6 +87,9 @@ Designed for IT consultants, M&A teams, and technical due diligence professional
         'Modules\Invoke-Compliance-Audit.ps1',
         'Modules\New-AuditReport.ps1',
         'Modules\New-AdvancedAuditReports.ps1',
+        'Modules\Invoke-Analytics-Engine.ps1',
+        'Modules\New-ExecutiveDashboard.ps1',
+        'Modules\Send-AnalyticsAlert.ps1',
         'Libraries\SQLite-AuditDB.ps1',
         'Utilities\Decrypt-AuditData.ps1'
     )
@@ -104,14 +111,28 @@ Designed for IT consultants, M&A teams, and technical due diligence professional
         'New-AuditReport',
         'New-AdvancedAuditReports',
 
+        # Analytics Engine (v2.3.0)
+        'Compare-AuditData',
+        'Get-TrendAnalysis',
+        'Find-Anomalies',
+        'Get-RiskScore',
+        'New-ExecutiveDashboard',
+        'Send-AnalyticsAlert',
+        'Test-AlertThresholds',
+        'Send-AlertEmail',
+        
         # SQLite database
         'Initialize-AuditDatabase',
         'Import-AuditCSVsToDatabase',
         'Import-CSVToTable',
         'Invoke-AuditQuery',
+        'Get-DatabaseConnection',
+        'Invoke-DatabaseQuery',
 
         # Utilities
-        'Decrypt-AuditData'
+        'Unprotect-EFSFolder',
+        'Unprotect-ArchiveFile',
+        'Unprotect-KeyVaultFiles'
     )
 
     # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
@@ -133,6 +154,7 @@ Designed for IT consultants, M&A teams, and technical due diligence professional
     FileList = @(
         'Run-M&A-Audit.ps1',
         'Start-M&A-Audit-GUI.ps1',
+        'Start-M&A-Analytics.ps1',
         'Start-M&A-QueryBuilder-GUI-POC.ps1',
         'Start-M&A-QueryBuilder-Web.ps1',
         'Setup-SQLite.ps1',
@@ -164,7 +186,13 @@ Designed for IT consultants, M&A teams, and technical due diligence professional
                 'Security',
                 'Compliance',
                 'Reporting',
+                'Analytics',
+                'Risk-Assessment',
+                'Dashboard',
+                'Anomaly-Detection',
                 'Technical-Discovery',
+                'Query-Builder',
+                'SQLite',
                 'PSEdition_Desktop',
                 'PSEdition_Core',
                 'Windows'
@@ -181,43 +209,79 @@ Designed for IT consultants, M&A teams, and technical due diligence professional
 
             # ReleaseNotes of this module
             ReleaseNotes = @'
-## Version 2.0.0 (2025-10-22)
-
-### New Features
-- Comprehensive Pester testing framework (110+ tests, ~75% coverage)
+## Version 2.3.0 (2025-10-22) - Advanced Analytics & Reporting
+
+### 🚀 New Major Features
+- **Advanced Analytics Engine**: Baseline comparison, trend analysis, anomaly detection
+- **Risk Scoring System**: Comprehensive 0-100 security risk score
+- **Executive Dashboards**: Beautiful HTML reports with risk gauges and interactive charts
+- **Alert System**: Email notifications for threshold breaches (SMTP integration)
+- **Query Builder Enhancements**: 20 templates (was 8), saved queries, query history, dark mode, Chart.js visualization
+
+### 📊 Analytics Capabilities
+- Baseline vs Current comparison (7 entity types tracked)
+- 7 anomaly types (privileged accounts, Kerberos, ACLs, databases, servers)
+- Risk levels: Low/Medium/High/Critical with color-coding
+- Trend analysis across multiple audits
+- Configurable alert thresholds
+
+### 🎨 Dashboard Features
+- Animated risk gauge (circular, color-coded)
+- Interactive metric cards with change indicators
+- Anomaly cards with severity badges
+- Executive summary section
+- Responsive design (mobile-friendly, print-optimized)
+- Professional gradients and animations
+
+### 🔔 Alert System
+- 6 alert types with configurable thresholds
+- HTML-formatted email notifications
+- SMTP support (Office 365, Gmail, Exchange)
+- Actionable recommendations
+
+### 📈 Query Builder v2.2
+- 20 pre-built query templates (12 new)
+- Saved queries with descriptions
+- Query history (last 100 executions)
+- Chart visualization (Bar, Line, Pie)
+- Dark mode with localStorage persistence
+- Advanced filters (IN, BETWEEN operators)
+
+### 🔒 Security Enhancements (v2.1)
+- ACL analysis (dangerous permissions detection)
+- Kerberos delegation audit (unconstrained/constrained)
+- DHCP scope inventory
+- GPO comprehensive inventory
+- Service account security analysis
+- AD trust relationships audit
+- Password policy analysis (default + fine-grained)
+- DNS zone inventory
+- Certificate Services audit
+
+### 📝 Documentation
+- Analytics Guide (550+ lines)
+- Query Builder Enhancements Guide (500+ lines)
+- AD Security Components Guide
+- Complete PowerShell Gallery publishing guide
+
+### 🧪 Testing & Quality
+- 118+ Pester tests (~78% coverage)
+- Zero linter errors
+- Comprehensive error handling
 - CI/CD integration (GitHub Actions + Azure DevOps)
-- Email notification system
-- PowerShell module manifest for professional packaging
-- Production-ready enterprise deployment
-
-### Core Capabilities
-- Active Directory comprehensive audit (16 components)
-- Server hardware and application inventory
-- SQL Server discovery and analysis
-- Microsoft 365 full audit (Entra ID, Exchange, SharePoint, Teams)
-- Power Platform audit (apps, flows, DLP)
-- Compliance and security audit (retention, DLP, sensitivity labels)
-- HTML reporting suite (5 reports + executive dashboard)
-- SQLite database integration for advanced queries
-- Enterprise encryption (EFS, 7-Zip, Azure Key Vault)
 
-### Test Coverage
-- SQLite database operations (25+ tests)
-- AD audit functions (30+ tests)
-- Cloud services (25+ tests)
-- Integration tests (10+ tests)
-- Utilities and helpers (20+ tests)
-
-### Bug Fixes
-- Fixed variable scoping in parallel processing
-- Resolved linter warnings
-- Improved error handling in server inventory
-
-### Documentation
-- Complete Pester testing documentation
-- CI/CD integration guides
-- Module packaging instructions
-- Quick start guides
+### 🛠️ Technical Details
+- 3 new analytics modules (~1,700 lines)
+- Start-M&A-Analytics.ps1 orchestrator (360 lines)
+- Risk scoring with 7 factors
+- Anomaly detection with 7 types
+- JSON/CSV/HTML output formats
+
+### 📦 Total Value
+- ~6,100 lines of production code
+- ~2,000 lines of documentation
+- 5 releases (v2.0 → v2.3)
+- Enterprise-grade M&A audit platform
 '@
 
             # Prerelease string of this module