refactor: reorganize repo — eliminate src/, promote tools to first-class dirs

- Eliminate src/ directory entirely
- common/ — shared PowerShell modules (6), helpers, ansible common role, keyvault bicep
- tools/vmfleet/ — full implementation with scripts, monitoring, infrastructure, reports, config, tests, logs
- tools/fio|hammerdb|iperf|stress-ng/ — each with playbooks, ansible roles, config, stubs
- tests/ — common/ for module tests; PSScriptAnalyzer stays at root
- config/ — variables.example.yml + variables/variables.yml + variables/variables.schema.json
- Removed config/clusters/, config/credentials/ (belong in demo-repository)
- Updated all internal path references in scripts and tests
- Updated all CI workflows (GitHub Actions, Azure DevOps, GitLab CI)

Author: Kristopher Turner

.azuredevops/azure-pipelines-vmfleet.yml

@@ -39,7 +39,7 @@ stages:
             displayName: 'Initialize Environment'
             inputs:
               targetType: filePath
-              filePath: src/core/powershell/helpers/Initialize-Environment.ps1
+              filePath: common/helpers/Initialize-Environment.ps1
               arguments: >
                 -ProjectRoot $(Build.SourcesDirectory)
                 -ClusterConfigPath $(Build.SourcesDirectory)/config/clusters/${{ parameters.clusterConfig }}
@@ -57,7 +57,7 @@ stages:
 
                 $params = @{
                   ClusterConfigPath = "$(Build.SourcesDirectory)/config/clusters/${{ parameters.clusterConfig }}"
-                  ProfilePath       = "$(Build.SourcesDirectory)/config/profiles/vmfleet/${{ parameters.profile }}"
+                  ProfilePath       = "$(Build.SourcesDirectory)/tools/vmfleet/config/profiles/${{ parameters.profile }}"
                   ProjectRoot       = "$(Build.SourcesDirectory)"
                   Credential        = $credential
                   ReportFormats     = @('PDF', 'XLSX')
@@ -67,7 +67,7 @@ stages:
                   $params['SkipCleanup'] = $true
                 }
 
-                & "$(Build.SourcesDirectory)/src/solutions/vmfleet/Invoke-VMFleetPipeline.ps1" @params
+                & "$(Build.SourcesDirectory)/tools/vmfleet/Invoke-VMFleetPipeline.ps1" @params
 
           - task: PublishBuildArtifacts@1
             displayName: 'Publish Reports'

.azuredevops/azure-pipelines.yml

@@ -11,7 +11,8 @@ trigger:
       - main
   paths:
     include:
-      - src/**
+      - common/**
+      - tools/**
       - tests/**
       - docs/**
       - config/**
@@ -52,9 +53,9 @@ stages:
               script: |
                 Install-Module powershell-yaml -Force -Scope CurrentUser
                 Import-Module powershell-yaml
-                # Validate master config loads without errors
-                $config = Get-Content config/variables/master-environment.yml -Raw | ConvertFrom-Yaml
-                Write-Host "Master config loaded: $($config.variables.Count) variables"
+                # Validate variables config loads without errors
+                $config = Get-Content config/variables/variables.yml -Raw | ConvertFrom-Yaml
+                Write-Host "Variables config loaded: $($config.variables.Count) variables"
 
   - stage: Test
     displayName: 'Unit Tests'
@@ -79,7 +80,7 @@ stages:
               pwsh: true
               script: |
                 $config = New-PesterConfiguration
-                $config.Run.Path = 'tests'
+                $config.Run.Path = @('tests', 'tools')
                 $config.Run.Exit = $true
                 $config.TestResult.Enabled = $true
                 $config.TestResult.OutputPath = '$(Build.ArtifactStagingDirectory)/test-results.xml'

.github/workflows/lint.yml

@@ -10,15 +10,17 @@ on:
   push:
     branches: [main]
     paths:
-      - 'src/**/*.ps1'
-      - 'src/**/*.psm1'
+      - 'common/**/*.ps1'
+      - 'common/**/*.psm1'
+      - 'tools/**/*.ps1'
       - 'tests/**/*.ps1'
       - '.github/workflows/lint.yml'
   pull_request:
     branches: [main]
     paths:
-      - 'src/**/*.ps1'
-      - 'src/**/*.psm1'
+      - 'common/**/*.ps1'
+      - 'common/**/*.psm1'
+      - 'tools/**/*.ps1'
       - 'tests/**/*.ps1'
   workflow_dispatch:
 

.github/workflows/run-tests.yml

@@ -10,13 +10,15 @@ on:
   push:
     branches: [main]
     paths:
-      - 'src/**'
+      - 'common/**'
+      - 'tools/**'
       - 'tests/**'
       - '.github/workflows/run-tests.yml'
   pull_request:
     branches: [main]
     paths:
-      - 'src/**'
+      - 'common/**'
+      - 'tools/**'
       - 'tests/**'
   workflow_dispatch:
 
@@ -42,14 +44,14 @@ jobs:
         shell: pwsh
         run: |
           $config = New-PesterConfiguration
-          $config.Run.Path = 'tests'
+          $config.Run.Path = @('tests', 'tools')
           $config.Run.Exit = $true
           $config.Output.Verbosity = 'Detailed'
           $config.TestResult.Enabled = $true
           $config.TestResult.OutputPath = 'test-results.xml'
           $config.TestResult.OutputFormat = 'NUnitXml'
           $config.CodeCoverage.Enabled = $true
-          $config.CodeCoverage.Path = @('src/core/powershell/modules')
+          $config.CodeCoverage.Path = @('common/modules')
           $config.CodeCoverage.OutputPath = 'coverage.xml'
           $config.CodeCoverage.OutputFormat = 'JaCoCo'
 

.github/workflows/run-vmfleet.yml

@@ -15,7 +15,7 @@ on:
         required: true
         default: 'example-cluster.yml'
       profile:
-        description: 'Workload profile (relative to config/profiles/vmfleet/)'
+        description: 'Workload profile (relative to tools/vmfleet/config/profiles/)'
         required: false
         default: 'general.yml'
       report_formats:
@@ -67,7 +67,7 @@ jobs:
       - name: Initialize environment
         shell: pwsh
         run: |
-          & "$env:PROJECT_ROOT\src\core\powershell\helpers\Initialize-Environment.ps1" `
+          & "$env:PROJECT_ROOT\common\helpers\Initialize-Environment.ps1" `
             -ProjectRoot $env:PROJECT_ROOT `
             -ClusterConfigPath "$env:PROJECT_ROOT\config\clusters\${{ inputs.cluster_config }}" `
             -Solution VMFleet
@@ -92,7 +92,7 @@ jobs:
 
           $profileInput = '${{ inputs.profile }}'
           if ($profileInput) {
-            $params['ProfilePath'] = "$env:PROJECT_ROOT\config\profiles\vmfleet\$profileInput"
+            $params['ProfilePath'] = "$env:PROJECT_ROOT\tools\vmfleet\config\profiles\$profileInput"
           }
 
           if ('${{ inputs.skip_cleanup }}' -eq 'true') {
@@ -103,7 +103,7 @@ jobs:
             $params['IncludeAzureMonitor'] = $true
           }
 
-          & "$env:PROJECT_ROOT\src\solutions\vmfleet\Invoke-VMFleetPipeline.ps1" @params
+          & "$env:PROJECT_ROOT\tools\vmfleet\Invoke-VMFleetPipeline.ps1" @params
 
       - name: Upload test reports
         if: always()

.github/workflows/validate-config.yml

@@ -47,7 +47,7 @@ jobs:
           with open('config/variables.example.yml') as f:
               data = yaml.safe_load(f)
 
-          with open('config/schema/variables.schema.json') as f:
+          with open('config/variables/variables.schema.json') as f:
               schema = json.load(f)
 
           try:

.github/workflows/validate-repo-structure.yml

@@ -55,8 +55,8 @@ jobs:
               echo "::error::Missing config/variables.example.yml"
               missing=$((missing + 1))
             fi
-            if [ ! -f "config/schema/variables.schema.json" ]; then
-              echo "::error::Missing config/schema/variables.schema.json"
+            if [ ! -f "config/variables/variables.schema.json" ]; then
+              echo "::error::Missing config/variables/variables.schema.json"
               missing=$((missing + 1))
             fi
             if [ $missing -gt 0 ]; then

.gitlab-ci.yml

@@ -18,8 +18,9 @@ lint-powershell:
     - pwsh -File tests/PSScriptAnalyzer.ps1 -ProjectRoot $CI_PROJECT_DIR
   rules:
     - changes:
-        - "src/**/*.ps1"
-        - "src/**/*.psm1"
+        - "common/**/*.ps1"
+        - "common/**/*.psm1"
+        - "tools/**/*.ps1"
         - "tests/**/*.ps1"
 
 validate-config:
@@ -52,7 +53,7 @@ pester-tests:
     - |
       pwsh -Command "
         \$config = New-PesterConfiguration
-        \$config.Run.Path = 'tests'
+        \$config.Run.Path = @('tests', 'tools')
         \$config.Run.Exit = \$true
         \$config.TestResult.Enabled = \$true
         \$config.TestResult.OutputPath = 'test-results.xml'
@@ -64,7 +65,8 @@ pester-tests:
       junit: test-results.xml
   rules:
     - changes:
-        - "src/**"
+        - "common/**"
+        - "tools/**"
         - "tests/**"
 
 # ---- Docs Stage ----