Merge branch 'main' into dependabot/github_actions/github-actions-7a5a078ad4

Author: MariusStorhaug

.github/actions/Build-PSModule/src/helpers/Build/Build-PSModuleManifest.ps1

@@ -260,7 +260,8 @@
             Write-Host "Processing required module [$requiredModuleName]"
             $requiredVersion = $group.Group.RequiredVersion | ForEach-Object { [Version]$_ } | Sort-Object -Unique
             $minimumVersion = $group.Group.Version | ForEach-Object { [Version]$_ } | Sort-Object -Unique | Select-Object -Last 1
-            $maximumVersion = $group.Group.MaximumVersion | ForEach-Object { [Version]$_ } | Sort-Object -Unique | Select-Object -First 1
+            $maximumVersion = $group.Group.MaximumVersion | Sort-Object -Unique | Select-Object -First 1
+            $maximumVersionBound = if ($maximumVersion -and ($maximumVersion -notmatch '[*]')) { [Version]$maximumVersion } else { $null }
             Write-Host "RequiredVersion: [$($requiredVersion -join ', ')]"
             Write-Host "ModuleVersion:   [$minimumVersion]"
             Write-Host "MaximumVersion:  [$maximumVersion]"
@@ -274,17 +275,17 @@
             }
 
             if (-not $maximumVersion) {
-                $maximumVersion = [Version]'9999.9999.9999'
+                $maximumVersionBound = [Version]'9999.9999.9999'
             }
 
             if ($requiredVersion -and ($minimumVersion -gt $requiredVersion)) {
                 throw 'ModuleVersion is higher than RequiredVersion.'
             }
 
-            if ($minimumVersion -gt $maximumVersion) {
+            if ($maximumVersionBound -and ($minimumVersion -gt $maximumVersionBound)) {
                 throw 'ModuleVersion is higher than MaximumVersion.'
             }
-            if ($requiredVersion -and ($requiredVersion -gt $maximumVersion)) {
+            if ($requiredVersion -and $maximumVersionBound -and ($requiredVersion -gt $maximumVersionBound)) {
                 throw 'RequiredVersion is higher than MaximumVersion.'
             }
 
@@ -294,15 +295,15 @@
                     ModuleName      = $requiredModuleName
                     RequiredVersion = $requiredVersion
                 }
-            } elseif (($minimumVersion -ne [Version]'0.0.0') -or ($maximumVersion -ne [Version]'9999.9999.9999')) {
+            } elseif (($minimumVersion -ne [Version]'0.0.0') -or ($maximumVersionBound -ne [Version]'9999.9999.9999')) {
                 Write-Host '[RequiredModules] - ModuleVersion/MaximumVersion'
                 $uniqueModule = @{
                     ModuleName = $requiredModuleName
                 }
                 if ($minimumVersion -ne [Version]'0.0.0') {
                     $uniqueModule['ModuleVersion'] = $minimumVersion
                 }
-                if ($maximumVersion -ne [Version]'9999.9999.9999') {
+                if ($maximumVersionBound -ne [Version]'9999.9999.9999') {
                     $uniqueModule['MaximumVersion'] = $maximumVersion
                 }
             } else {

.github/actions/Install-PSModule/src/PSModule/PSModule.psm1

@@ -87,18 +87,40 @@ function Convert-VersionSpec {
         [string] $RequiredVersion
     )
 
+    $maximumVersionIsWildcard = $MaximumVersion -and ($MaximumVersion -match '[*]')
+    if ($maximumVersionIsWildcard) {
+        $versionParts = @($MaximumVersion -split '\.')
+        $wildcardIndex = [Array]::IndexOf($versionParts, '*')
+        if ($wildcardIndex -lt 0) {
+            throw "MaximumVersion '$MaximumVersion' contains an unsupported wildcard pattern."
+        }
+
+        if ($wildcardIndex -eq 0) {
+            throw "MaximumVersion '$MaximumVersion' contains an unsupported wildcard pattern."
+        }
+
+        $upperBoundParts = @(0, 0, 0)
+        for ($i = 0; $i -lt $wildcardIndex; $i++) {
+            $upperBoundParts[$i] = [int]$versionParts[$i]
+        }
+        $upperBoundParts[$wildcardIndex - 1]++
+        $MaximumVersion = $upperBoundParts -join '.'
+    }
+
     if ($RequiredVersion) {
         # Use exact match in bracket notation.
         return "[$RequiredVersion]"
     } elseif ($MinimumVersion -and $MaximumVersion) {
-        # Both bounds provided; both are inclusive.
-        return "[$MinimumVersion,$MaximumVersion]"
+        # Wildcard maximum versions are translated to an exclusive upper bound.
+        $upperBound = $maximumVersionIsWildcard ? ')' : ']'
+        return "[$MinimumVersion,$MaximumVersion$upperBound"
     } elseif ($MinimumVersion) {
         # Only a minimum is provided. Use a minimum-inclusive range.
         return "[$MinimumVersion, ]"
     } elseif ($MaximumVersion) {
-        # Only a maximum is provided; lower bound open.
-        return "(, $MaximumVersion]"
+        # Only a maximum is provided; lower bound open. Wildcards are exclusive upper bounds.
+        $upperBound = $maximumVersionIsWildcard ? ')' : ']'
+        return "(, $MaximumVersion$upperBound"
     } else {
         return $null
     }

AGENTS.md

@@ -0,0 +1,38 @@
+# Agents
+
+## Main directive
+
+Everything is a work in progress and can be improved.
+If you find a problem or improvement, fix if small; otherwise open an issue.
+
+## Repo guidance
+
+- [`README.md`](README.md) — what this repository is and its purpose as the
+  Process-PSModule framework.
+
+## PSModule Framework guidance
+
+Regarding repo structure, module source code, and how the Process-PSModule workflow
+works. For PSModule-specific build, layout, and process guidance:
+
+- [Process-PSModule docs](https://psmodule.github.io/docs/Modules/Process-PSModule/) —
+  repository structure, module anatomy, and the build/test/pack/publish pipeline.
+- [Repository defaults](https://psmodule.github.io/docs/Modules/Repository-Defaults/) —
+  the expected repository layout and required files.
+- [Standards](https://psmodule.github.io/docs/Modules/Standards/) — PowerShell module
+  coding standards.
+- [PSModule/memory](https://github.com/PSModule/memory) — durable cross-session agent
+  working memory for the PSModule organization.
+
+## Org-wide guidance
+
+For cross-cutting ways of working and standards:
+
+- [Agentic Development](https://msxorg.github.io/docs/Ways-of-Working/Agentic-Development/) —
+  how agents and humans collaborate in this ecosystem.
+- [Ways of Working](https://msxorg.github.io/docs/Ways-of-Working/) — contribution
+  workflow, branching, PRs, issues.
+- [Coding Standards](https://msxorg.github.io/docs/Coding-Standards/) — language-level
+  conventions.
+- [MSXOrg/memory](https://github.com/MSXOrg/memory) — durable agent working memory:
+  gotchas, knowledge, and agent role notes.

tests/srcTestRepo/src/functions/public/PSModule/Get-PSModuleTest.ps1

@@ -1,6 +1,6 @@
 #Requires -Modules Utilities
 #Requires -Modules @{ ModuleName = 'PSSemVer'; RequiredVersion = '1.1.4' }
-#Requires -Modules @{ ModuleName = 'DynamicParams'; ModuleVersion = '1.1.8' }
+#Requires -Modules @{ ModuleName = 'ThreadJob'; ModuleVersion = '1.0.0'; MaximumVersion = '1.*' }
 #Requires -Modules @{ ModuleName = 'Store'; ModuleVersion = '0.3.1' }
 
 function Get-PSModuleTest {

tests/srcWithManifestTestRepo/src/functions/public/PSModule/Get-PSModuleTest.ps1

@@ -1,6 +1,6 @@
 #Requires -Modules Utilities
 #Requires -Modules @{ ModuleName = 'PSSemVer'; RequiredVersion = '1.1.4' }
-#Requires -Modules @{ ModuleName = 'DynamicParams'; ModuleVersion = '1.1.8' }
+#Requires -Modules @{ ModuleName = 'ThreadJob'; ModuleVersion = '1.0.0'; MaximumVersion = '1.*' }
 #Requires -Modules @{ ModuleName = 'Store'; ModuleVersion = '0.3.1' }
 
 function Get-PSModuleTest {