feat(#177): add Import-BuiltCiModule script for module import process

- implement parameter handling for repository root and project name
- check for built module manifest existence before import
- replace Install-CiPowerShellModules with Import-BuiltCiModule in Publish.yml

Author: stiwicourage

.github/workflows/Publish.yml

@@ -81,7 +81,7 @@ jobs:
           git checkout develop
           git reset --hard origin/main
 
-          ./scripts/build/ci/Install-CiPowerShellModules.ps1
+          ./scripts/build/ci/Import-BuiltCiModule.ps1 | Out-Null
 
           Update-NovaModuleVersion -Preview -Verbose
 
@@ -100,7 +100,7 @@ jobs:
             Register-PSResourceRepository -PSGallery
           }
 
-          ./scripts/build/ci/Install-CiPowerShellModules.ps1
+          ./scripts/build/ci/Import-BuiltCiModule.ps1 | Out-Null
 
           Publish-NovaModule -Repository PSGallery -ApiKey $env:PSGALLERY_API
 

project.json

@@ -1,7 +1,7 @@
 {
   "ProjectName": "NovaModuleTools",
   "Description": "NovaModuleTools is an enterprise-focused evolution of ModuleTools, designed for large-scale PowerShell projects with a strong emphasis on structure, maintainability, and automated CI/CD pipelines.",
-  "Version": "2.0.0-preview96",
+  "Version": "2.0.0-preview97",
   "Preamble": [
     "Set-StrictMode -Version Latest",
     "$ErrorActionPreference = 'Stop'"

scripts/build/ci/Import-BuiltCiModule.ps1

@@ -0,0 +1,20 @@
+param(
+    [string]$RepositoryRoot = (Resolve-Path -LiteralPath (Join-Path $PSScriptRoot '..' '..' '..')).Path,
+    [string]$ProjectName
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+if ( [string]::IsNullOrWhiteSpace($ProjectName)) {
+    $projectJsonPath = Join-Path $RepositoryRoot 'project.json'
+    $ProjectName = (Get-Content -LiteralPath $projectJsonPath -Raw | ConvertFrom-Json).ProjectName
+}
+
+$moduleManifestPath = Join-Path $RepositoryRoot "dist/$ProjectName/$ProjectName.psd1"
+if (-not (Test-Path -LiteralPath $moduleManifestPath)) {
+    throw "Built module manifest not found: $moduleManifestPath"
+}
+
+Remove-Module -Name $ProjectName -Force -ErrorAction SilentlyContinue
+return Import-Module -Name $moduleManifestPath -Force -PassThru -ErrorAction Stop