feat(delivery): ✨ standardize manifest delivery metadata to PrivateData.PSData.Delivery/Repository

* Replace legacy `PSPublishModuleDelivery` references in docs and cmdlets with `PrivateData.PSData.Delivery`.
* Update `New-PersonalManifest.ps1` to emit a structured `Delivery` node and an optional `Repository` node (branch/paths), and include `Delivery`/`Repository` in validated PrivateData entries.
* Update public cmdlets (`Install-ProjectDocumentation`, `Show-ProjectDocumentation`) and documentation to read from the new nodes.
* Fix minor typo in `Build-Module.ps1` ("rmeove" → "remove").

Author: PrzemyslawKlys

Module/Build/Build-Module.ps1

@@ -3,7 +3,7 @@
 # most modules should be run via PSD1 or by it's name (which in the background uses PD1)
 
 # This version is for local building
-# We need to rmeove library before we start, as it may contain old files, which will be in use once PSD1 loads
+# We need to remove library before we start, as it may contain old files, which will be in use once PSD1 loads
 # This is only required for PSPublisModule, as it's the only module that is being built by itself
 Remove-Item -Path "C:\Support\GitHub\PSPublishModule\Module\Lib" -Recurse -Force -ErrorAction SilentlyContinue
 

Module/Docs/Install-ProjectDocumentation.md

@@ -28,7 +28,7 @@ Install-ProjectDocumentation [-Module <PSModuleInfo>] [-RequiredVersion <Version
 
 ## DESCRIPTION
 Copies the contents of a module's Internals folder (or the path defined in
-PrivateData.PSData.PSPublishModuleDelivery) to a destination outside of
+PrivateData.PSData.Delivery) to a destination outside of
 $env:PSModulePath, including subfolders such as Scripts, Docs, Binaries, Config.
 When -IncludeRootReadme/-IncludeRootChangelog/-IncludeRootLicense are enabled in
 New-ConfigurationDelivery, root README/CHANGELOG/LICENSE are also copied.

Module/Docs/New-ConfigurationDelivery.md

@@ -23,7 +23,7 @@ New-ConfigurationDelivery [-Enable] [[-InternalsPath] <String>] [-IncludeRootRea
 
 ## DESCRIPTION
 Adds Delivery options to the PSPublishModule configuration so the build embeds
-discovery metadata in the manifest (PrivateData.PSData.PSPublishModuleDelivery)
+runtime metadata in the manifest (PrivateData.PSData.Delivery and PrivateData.PSData.Repository)
 and so the Internals folder is easy to find post-install by helper cmdlets
 such as Install-ModuleDocumentation.
 
@@ -36,7 +36,7 @@ directory is physically included in the shipped module and discoverable later.
 ### EXAMPLE 1
 ```
 New-ConfigurationDelivery -Enable -InternalsPath 'Internals' -IncludeRootReadme -IncludeRootChangelog
-Emits Options.Delivery and causes PrivateData.PSData.PSPublishModuleDelivery to be written in the manifest.
+Emits Options.Delivery and causes PrivateData.PSData.Delivery/Repository to be written in the manifest.
 ```
 
 ### EXAMPLE 2

Module/Docs/Show-ProjectDocumentation.md

@@ -35,7 +35,7 @@ Show-ProjectDocumentation [-RequiredVersion <Version>] [-DocsPath <String>] [-Re
 
 ## DESCRIPTION
 Finds a module (by name or PSModuleInfo) and renders README/CHANGELOG from the module root
-or from its Internals folder (as defined in PrivateData.PSData.PSPublishModuleDelivery).
+or from its Internals folder (as defined in PrivateData.PSData.Delivery).
 You can also point directly to a docs folder via -DocsPath (e.g., output of Install-ModuleDocumentation).
 
 ## EXAMPLES
@@ -220,7 +220,7 @@ Accept wildcard characters: False
 ```
 
 ### -Intro
-Show introduction text defined in PrivateData.PSData.PSPublishModuleDelivery.IntroText when available.
+Show introduction text defined in PrivateData.PSData.Delivery.IntroText when available.
 If not defined,
 falls back to README resolution (root vs Internals honoring -PreferInternals).
 
@@ -237,7 +237,7 @@ Accept wildcard characters: False
 ```
 
 ### -Upgrade
-Show upgrade text defined in PrivateData.PSData.PSPublishModuleDelivery.UpgradeText when available.
+Show upgrade text defined in PrivateData.PSData.Delivery.UpgradeText when available.
 If not defined,
 looks for an UPGRADE* file; otherwise throws.
 
@@ -271,7 +271,7 @@ Accept wildcard characters: False
 ```
 
 ### -Links
-Print ImportantLinks defined in PrivateData.PSData.PSPublishModuleDelivery after the selected documents.
+Print ImportantLinks defined in PrivateData.PSData.Delivery after the selected documents.
 
 ```yaml
 Type: SwitchParameter

Module/Private/New-PersonalManifest.ps1

@@ -99,7 +99,7 @@ function New-PersonalManifest {
         if ($Data.Path) {
             $Data.Remove('Path')
         }
-        $ValidateEntriesPrivateData = @('Tags', 'LicenseUri', 'ProjectURI', 'IconUri', 'ReleaseNotes', 'Prerelease', 'RequireLicenseAcceptance', 'ExternalModuleDependencies', 'PSPublishModuleDelivery')
+        $ValidateEntriesPrivateData = @('Tags', 'LicenseUri', 'ProjectURI', 'IconUri', 'ReleaseNotes', 'Prerelease', 'RequireLicenseAcceptance', 'ExternalModuleDependencies', 'Delivery', 'Repository')
         foreach ($Entry in [string[]] $Data.Keys) {
             if ($Entry -in $ValidateEntriesPrivateData) {
                 $Data.PrivateData.PSData.$Entry = $Data.$Entry
@@ -124,9 +124,31 @@ function New-PersonalManifest {
         if ($Configuration.Steps.PublishModule.Prerelease) {
             $Data.PrivateData.PSData.Prerelease = $Configuration.Steps.PublishModule.Prerelease
         }
-        # Emit delivery metadata when provided
+        # Emit Delivery/Repository metadata (runtime-only) when provided
         if ($Configuration.Options.Delivery -and $Configuration.Options.Delivery.Enable) {
-            $Data.PrivateData.PSData.PSPublishModuleDelivery = $Configuration.Options.Delivery
+            $deliveryCfg = $Configuration.Options.Delivery
+            # Build runtime Delivery node
+            $deliveryNode = [ordered] @{
+                InternalsPath       = $deliveryCfg.InternalsPath
+                ImportantLinks      = $deliveryCfg.ImportantLinks
+                IntroText           = $deliveryCfg.IntroText
+                UpgradeText         = $deliveryCfg.UpgradeText
+                IntroFile           = $deliveryCfg.IntroFile
+                UpgradeFile         = $deliveryCfg.UpgradeFile
+                DocumentationOrder  = $deliveryCfg.DocumentationOrder
+            }
+            Remove-EmptyValue -Hashtable $deliveryNode
+            $Data.PrivateData.PSData.Delivery = $deliveryNode
+
+            # Build Repository node (branch/paths only)
+            $repositoryNode = [ordered] @{
+                Branch = $deliveryCfg.RepositoryBranch
+                Paths  = $deliveryCfg.RepositoryPaths
+            }
+            Remove-EmptyValue -Hashtable $repositoryNode
+            if ($repositoryNode.Count -gt 0) {
+                $Data.PrivateData.PSData.Repository = $repositoryNode
+            }
         }
         if ($TemporaryManifest.ExternalModuleDependencies) {
             # Add External Module Dependencies

Module/Public/Install-ProjectDocumentation.ps1

@@ -5,7 +5,7 @@ function Install-ProjectDocumentation {
 
     .DESCRIPTION
     Copies the contents of a module's Internals folder (or the path defined in
-    PrivateData.PSData.PSPublishModuleDelivery) to a destination outside of
+    PrivateData.PSData.Delivery) to a destination outside of
     $env:PSModulePath, including subfolders such as Scripts, Docs, Binaries, Config.
     When -IncludeRootReadme/-IncludeRootChangelog/-IncludeRootLicense are enabled in
     New-ConfigurationDelivery, root README/CHANGELOG/LICENSE are also copied.
@@ -152,7 +152,7 @@ function Install-ProjectDocumentation {
         }
 
         $manifest = Test-ModuleManifest -Path $manifestPath
-        $delivery = $manifest.PrivateData.PSData.PSPublishModuleDelivery
+        $delivery = $manifest.PrivateData.PSData.Delivery
 
         $internalsRel = if ($delivery -and $delivery.InternalsPath) { [string]$delivery.InternalsPath } else { 'Internals' }
         $includeReadme = if ($null -ne $delivery.IncludeRootReadme) { [bool]$delivery.IncludeRootReadme } else { $true }

Module/Public/New-ConfigurationDelivery.ps1

@@ -5,7 +5,7 @@ function New-ConfigurationDelivery {
 
     .DESCRIPTION
     Adds Delivery options to the PSPublishModule configuration so the build embeds
-    discovery metadata in the manifest (PrivateData.PSData.PSPublishModuleDelivery)
+    runtime metadata in the manifest (PrivateData.PSData.Delivery and PrivateData.PSData.Repository)
     and so the Internals folder is easy to find post-install by helper cmdlets
     such as Install-ModuleDocumentation.
 
@@ -74,7 +74,7 @@ function New-ConfigurationDelivery {
 
     .EXAMPLE
     PS> New-ConfigurationDelivery -Enable -InternalsPath 'Internals' -IncludeRootReadme -IncludeRootChangelog
-    Emits Options.Delivery and causes PrivateData.PSData.PSPublishModuleDelivery to be written in the manifest.
+    Emits Options.Delivery and causes PrivateData.PSData.Delivery/Repository to be written in the manifest.
 
     .EXAMPLE
     PS> New-ConfigurationInformation -IncludeAll 'Internals\'

Module/Public/Show-ProjectDocumentation.ps1

@@ -5,7 +5,7 @@ function Show-ProjectDocumentation {
 
     .DESCRIPTION
     Finds a module (by name or PSModuleInfo) and renders README/CHANGELOG from the module root
-    or from its Internals folder (as defined in PrivateData.PSData.PSPublishModuleDelivery).
+    or from its Internals folder (as defined in PrivateData.PSData.Delivery).
     You can also point directly to a docs folder via -DocsPath (e.g., output of Install-ModuleDocumentation).
 
     .PARAMETER Name
@@ -32,19 +32,19 @@ function Show-ProjectDocumentation {
     the chosen area (root vs Internals).
 
     .PARAMETER Intro
-    Show introduction text defined in PrivateData.PSData.PSPublishModuleDelivery.IntroText when available. If not defined,
+    Show introduction text defined in PrivateData.PSData.Delivery.IntroText when available. If not defined,
     falls back to README resolution (root vs Internals honoring -PreferInternals).
 
     .PARAMETER Upgrade
-    Show upgrade text defined in PrivateData.PSData.PSPublishModuleDelivery.UpgradeText when available. If not defined,
+    Show upgrade text defined in PrivateData.PSData.Delivery.UpgradeText when available. If not defined,
     looks for an UPGRADE* file; otherwise throws.
 
     .PARAMETER All
     Show Introduction, README, CHANGELOG and LICENSE in a standard order. You can still add
     specific switches (e.g., -Changelog) and they will be included additively without duplication.
 
     .PARAMETER Links
-    Print ImportantLinks defined in PrivateData.PSData.PSPublishModuleDelivery after the selected documents.
+    Print ImportantLinks defined in PrivateData.PSData.Delivery after the selected documents.
 
     .PARAMETER File
     Relative path to a specific file to display (relative to module root or Internals). If rooted, used as-is.
@@ -165,7 +165,7 @@ function Show-ProjectDocumentation {
             $manifestPath = Join-Path $rootBase ("{0}.psd1" -f $Module.Name)
             $delivery = $null
             if (Test-Path -LiteralPath $manifestPath) {
-                try { $manifest = Test-ModuleManifest -Path $manifestPath; $delivery = $manifest.PrivateData.PSData.PSPublishModuleDelivery } catch {}
+                try { $manifest = Test-ModuleManifest -Path $manifestPath; $delivery = $manifest.PrivateData.PSData.Delivery } catch {}
             }
             $internalsRel = if ($delivery -and $delivery.InternalsPath) { [string]$delivery.InternalsPath } else { 'Internals' }
             $intCandidate = Join-Path $rootBase $internalsRel
@@ -242,20 +242,20 @@ function Show-ProjectDocumentation {
 
         foreach ($t in $targets) {
             if ($t.Kind -eq 'Intro') {
-                if ($manifest -and $manifest.PrivateData -and $manifest.PrivateData.PSData -and $manifest.PrivateData.PSData.PSPublishModuleDelivery -and $manifest.PrivateData.PSData.PSPublishModuleDelivery.IntroText) {
+                if ($manifest -and $manifest.PrivateData -and $manifest.PrivateData.PSData -and $manifest.PrivateData.PSData.Delivery -and $manifest.PrivateData.PSData.Delivery.IntroText) {
                     $title = if ($moduleName) { "$moduleName $moduleVersion - Introduction" } else { 'Introduction' }
                     Write-Heading -Text $title
-                    foreach ($line in [string[]]$manifest.PrivateData.PSData.PSPublishModuleDelivery.IntroText) { Write-Host $line }
+                    foreach ($line in [string[]]$manifest.PrivateData.PSData.Delivery.IntroText) { Write-Host $line }
                 } else {
                     Write-Warning 'Introduction text not defined in delivery metadata.'
                 }
                 continue
             }
             if ($t.Kind -eq 'Upgrade') {
-                if ($manifest -and $manifest.PrivateData -and $manifest.PrivateData.PSData -and $manifest.PrivateData.PSData.PSPublishModuleDelivery -and $manifest.PrivateData.PSData.PSPublishModuleDelivery.UpgradeText) {
+                if ($manifest -and $manifest.PrivateData -and $manifest.PrivateData.PSData -and $manifest.PrivateData.PSData.Delivery -and $manifest.PrivateData.PSData.Delivery.UpgradeText) {
                     $title = if ($moduleName) { "$moduleName $moduleVersion - Upgrade" } else { 'Upgrade' }
                     Write-Heading -Text $title
-                    foreach ($line in [string[]]$manifest.PrivateData.PSData.PSPublishModuleDelivery.UpgradeText) { Write-Host $line }
+                    foreach ($line in [string[]]$manifest.PrivateData.PSData.Delivery.UpgradeText) { Write-Host $line }
                 } else {
                     $f = Resolve-DocFile -Kind 'UPGRADE' -RootBase $rootBase -InternalsBase $internalsBase -PreferInternals:$PreferInternals
                     if ($f) {
@@ -285,7 +285,7 @@ function Show-ProjectDocumentation {
             Write-Host
         }
         if ($Links) {
-            $links = $manifest.PrivateData.PSData.PSPublishModuleDelivery.ImportantLinks
+            $links = $manifest.PrivateData.PSData.Delivery.ImportantLinks
             if ($links) {
                 Write-Heading -Text ((if ($moduleName) { "$moduleName $moduleVersion - Links" } else { 'Links' }))
                 foreach ($l in $links) {