[1.0.0-alpha1] Upgrade to psake 5.0.0 with task caching and LLM output

Breaking changes:
- Minimum PowerShell raised from 3.0 to 5.1
- psake dependency raised from 4.9.0 to 5.0.0
- Invoke-psake now returns PsakeBuildResult (replaces $psake.build_success)

New features:
- Content-addressed task caching via Inputs/Outputs on cacheable tasks
  (StageFiles, Analyze, Pester, GenerateMarkdown, GenerateMAML, GenerateUpdatableHelp)
- LLM-optimized test output mode ($PSBPreference.Test.OutputMode = 'LLM')
  emits structured JSON with only failure details
- External PesterConfiguration file support via $PSBPreference.Test.PesterConfigurationPath
- Direct PesterConfiguration object passthrough via -Configuration parameter
- Format-PSBuildResult function for Human/JSON/GitHubActions build result formatting
- All psakeFile.ps1 tasks rewritten to declarative hashtable syntax
- Invoke-Build IB.tasks.ps1 updated with matching Inputs/Outputs caching
- Windows PowerShell 5.1 CI matrix entry added

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: HeyItsGilbert

.github/workflows/test.yml

@@ -12,10 +12,15 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macOS-latest]
+        shell: [pwsh]
+        include:
+          - os: windows-latest
+            shell: powershell
+            name: 'Windows PowerShell 5.1'
     steps:
     - uses: actions/checkout@v4
     - name: Test
-      shell: pwsh
+      shell: ${{ matrix.shell }}
       env:
         DEBUG: ${{ runner.debug == '1' }}
       run: |

CHANGELOG.md

@@ -7,6 +7,48 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## Unreleased
 
+## [1.0.0-alpha1] 2026-03-22
+
+### Breaking Changes
+
+- **Minimum PowerShell version raised from 3.0 to 5.1.** PowerShellBuild 1.0.0+ requires
+  PowerShell 5.1 or later.
+- **psake 5.0.0 required.** The consumer-facing `psakeFile.ps1` now uses psake 5.0.0
+  declarative task syntax with `Version 5` pinning.
+- **`Invoke-psake` now returns `PsakeBuildResult`.** Build scripts that check
+  `$psake.build_success` should migrate to inspecting the returned object's `.Success` property.
+
+### Added
+
+- **Task caching** — Cacheable tasks (`StageFiles`, `Analyze`, `Pester`, `GenerateMarkdown`,
+  `GenerateMAML`, `GenerateUpdatableHelp`) now declare `Inputs`/`Outputs` for psake 5.0.0's
+  content-addressed caching. Unchanged tasks are automatically skipped on incremental builds.
+  Disable with `$PSBPreference.Build.EnableTaskCaching = $false`.
+- **LLM-optimized test output** — New `$PSBPreference.Test.OutputMode` setting with values
+  `'Detailed'` (default, verbose human output), `'Minimal'` (failures only, compact), and
+  `'LLM'` (structured JSON with failure details, optimized for machine consumption).
+- **External PesterConfiguration support** — New `$PSBPreference.Test.PesterConfigurationPath`
+  setting to load a `.psd1` file as the base PesterConfiguration. Explicit `$PSBPreference.Test`
+  values overlay on top.
+- **`-Configuration` parameter on `Test-PSBuildPester`** — Pass a `[PesterConfiguration]` object
+  directly for full control over Pester execution.
+- **`-OutputMode` parameter on `Test-PSBuildPester`** — Control output format per-invocation.
+- **`-PesterConfigurationPath` parameter on `Test-PSBuildPester`** — Load external config files.
+- **`Format-PSBuildResult`** — New public function to format psake 5.0.0's `PsakeBuildResult`
+  for Human, JSON, or GitHubActions output.
+- **Declarative task syntax** — All tasks in `psakeFile.ps1` rewritten to use psake 5.0.0's
+  hashtable-based declarative syntax.
+- **Invoke-Build parity** — `IB.tasks.ps1` updated with matching `Inputs`/`Outputs` caching
+  and new Pester parameter passthrough.
+
+### Changed
+
+- `$PSBPreference` now includes `Build.EnableTaskCaching`, `Test.OutputMode`, and
+  `Test.PesterConfigurationPath` keys.
+- `Test-PSBuildPester` now always returns the Pester test result object for programmatic access.
+- Synchronized inline `LocalizedData` in `PowerShellBuild.psm1` with all strings from
+  `en-US/Messages.psd1` (was missing signing-related strings from 0.8.0).
+
 ## [0.8.0] 2026-02-20
 
 ### Added

CLAUDE.md

@@ -4,10 +4,10 @@
 
 **PowerShellBuild** is a PowerShell module that provides a standardized set of build, test, and publish tasks for PowerShell module projects. It supports two popular PowerShell task-runner frameworks:
 
-- **psake** (4.9.0+) — task-based build system
-- **Invoke-Build** (5.8.1+) — alternative task runner
+- **psake** (5.0.0+) — task-based build system with declarative syntax and content-addressed caching
+- **Invoke-Build** (5.8.1+) — alternative task runner with native Inputs/Outputs caching
 
-The module version is **0.7.3** and targets PowerShell 3.0+. It is cross-platform and tested on Windows, Linux, and macOS.
+The module version is **1.0.0-alpha1** and targets PowerShell 5.1+. It is cross-platform and tested on Windows (including Windows PowerShell 5.1), Linux, and macOS.
 
 ---
 
@@ -26,8 +26,8 @@ PowerShellBuild/
 ├── Build/
 │   └── Convert-PSAke.ps1       # Utility: converts psake tasks to Invoke-Build
 ├── PowerShellBuild/            # THE MODULE SOURCE (System Under Test)
-│   ├── Public/                 # Exported (public) functions — 9 functions
-│   ├── Private/                # Internal functions — 1 function
+│   ├── Public/                 # Exported (public) functions — 13 functions
+│   ├── Private/                # Internal functions — 2 functions
 │   ├── en-US/
 │   │   └── Messages.psd1       # Localized string resources
 │   ├── PowerShellBuild.psd1    # Module manifest (version, deps, exports)
@@ -67,8 +67,8 @@ The hashtable is organized into sections:
 | Section | Purpose |
 |---------|---------|
 | `General` | ProjectRoot, SrcRootDir, ModuleName, ModuleVersion, ModuleManifestPath |
-| `Build` | OutDir, ModuleOutDir, CompileModule, CompileDirectories, CopyDirectories, Exclude |
-| `Test` | Enabled, RootDir, OutputFile, OutputFormat, ScriptAnalysis, CodeCoverage, ImportModule, SkipRemainingOnFailure, OutputVerbosity |
+| `Build` | OutDir, ModuleOutDir, CompileModule, CompileDirectories, CopyDirectories, Exclude, EnableTaskCaching |
+| `Test` | Enabled, RootDir, OutputFile, OutputFormat, ScriptAnalysis, CodeCoverage, ImportModule, SkipRemainingOnFailure, OutputVerbosity, OutputMode, PesterConfigurationPath |
 | `Help` | UpdatableHelpOutDir, DefaultLocale, ConvertReadMeToAboutHelp |
 | `Docs` | RootDir, Overwrite, AlphabeticParamsOrder, ExcludeDontShow, UseFullTypeName |
 | `Publish` | PSRepository, PSRepositoryApiKey, PSRepositoryCredential |
@@ -124,8 +124,11 @@ All functions reside in `PowerShellBuild/Public/`.
 | `Test-PSBuildPester` | Runs Pester tests with configurable output and coverage |
 | `Test-PSBuildScriptAnalysis` | Runs PSScriptAnalyzer with configurable severity threshold |
 | `Publish-PSBuildModule` | Publishes the built module to a PowerShell repository |
+| `Format-PSBuildResult` | Formats a PsakeBuildResult for Human, JSON, or GitHubActions output |
 
-Private helper: `Remove-ExcludedItem` — filters file system items by regex patterns during builds.
+Private helpers:
+- `Remove-ExcludedItem` — filters file system items by regex patterns during builds
+- `ConvertTo-PSBuildLLMOutput` — converts Pester results to structured JSON for LLM consumption
 
 ### Invoke-Build Alias
 
@@ -207,7 +210,7 @@ Defined in `requirements.psd1`, installed via **PSDepend**:
 |--------|---------|
 | BuildHelpers | 2.0.16 |
 | Pester | ≥ 5.6.1 |
-| psake | 4.9.0 |
+| psake | 5.0.0 |
 | PSScriptAnalyzer | 1.24.0 |
 | InvokeBuild | 5.8.1 |
 | platyPS | 0.14.2 |
@@ -386,7 +389,7 @@ After a successful build, output is in `Output/PowerShellBuild/<version>/`:
 ```
 Output/
 └── PowerShellBuild/
-    └── 0.7.3/
+    └── 1.0.0/
         ├── Public/                   # (when CompileModule = $false)
         ├── Private/
         ├── en-US/

PowerShellBuild/IB.tasks.ps1

@@ -13,7 +13,14 @@ Task Clean Init, {
 }
 
 # Synopsis: Builds module based on source directory
-Task StageFiles Clean, {
+Task StageFiles -Inputs {
+    Get-ChildItem -Path $PSBPreference.General.SrcRootDir -Recurse -File |
+        Where-Object { $_.Extension -in '.ps1', '.psm1', '.psd1', '.ps1xml', '.txt' }
+} -Outputs {
+    if (Test-Path $PSBPreference.Build.ModuleOutDir) {
+        Get-ChildItem -Path $PSBPreference.Build.ModuleOutDir -Recurse -File
+    }
+} Clean, {
     $buildParams = @{
         Path               = $PSBPreference.General.SrcRootDir
         ModuleName         = $PSBPreference.General.ModuleName
@@ -59,13 +66,19 @@ $analyzePreReqs = {
 }
 
 # Synopsis: Execute PSScriptAnalyzer tests
-Task Analyze -If (. $analyzePreReqs) Build, {
+Task Analyze -If (. $analyzePreReqs) -Inputs {
+    Get-ChildItem -Path $PSBPreference.Build.ModuleOutDir -Recurse -File -Include '*.ps1', '*.psm1', '*.psd1'
+} -Outputs {
+    Join-Path $PSBPreference.Build.OutDir '.analyze-ok'
+} Build, {
     $analyzeParams = @{
         Path              = $PSBPreference.Build.ModuleOutDir
         SeverityThreshold = $PSBPreference.Test.ScriptAnalysis.FailBuildOnSeverityLevel
         SettingsPath      = $PSBPreference.Test.ScriptAnalysis.SettingsPath
     }
     Test-PSBuildScriptAnalysis @analyzeParams
+    # Write marker file for cache validation
+    Set-Content -Path (Join-Path $PSBPreference.Build.OutDir '.analyze-ok') -Value (Get-Date -Format 'o')
 }
 
 $pesterPreReqs = {
@@ -86,7 +99,13 @@ $pesterPreReqs = {
 }
 
 # Synopsis: Execute Pester tests
-Task Pester -If (. $pesterPreReqs) Build, {
+Task Pester -If (. $pesterPreReqs) -Inputs {
+    $testFiles = Get-ChildItem -Path $PSBPreference.Test.RootDir -Recurse -File -Filter '*.ps1'
+    $moduleFiles = Get-ChildItem -Path $PSBPreference.Build.ModuleOutDir -Recurse -File -ErrorAction SilentlyContinue
+    @($testFiles) + @($moduleFiles)
+} -Outputs {
+    $PSBPreference.Test.OutputFile
+} Build, {
     $pesterParams = @{
         Path                         = $PSBPreference.Test.RootDir
         ModuleName                   = $PSBPreference.General.ModuleName
@@ -101,6 +120,10 @@ Task Pester -If (. $pesterPreReqs) Build, {
         ImportModule                 = $PSBPreference.Test.ImportModule
         SkipRemainingOnFailure       = $PSBPreference.Test.SkipRemainingOnFailure
         OutputVerbosity              = $PSBPreference.Test.OutputVerbosity
+        OutputMode                   = $PSBPreference.Test.OutputMode
+    }
+    if ($PSBPreference.Test.PesterConfigurationPath) {
+        $pesterParams.PesterConfigurationPath = $PSBPreference.Test.PesterConfigurationPath
     }
     Test-PSBuildPester @pesterParams
 }
@@ -117,7 +140,15 @@ $genMarkdownPreReqs = {
 }
 
 # Synopsis: Generates PlatyPS markdown files from module help
-Task GenerateMarkdown -if (. $genMarkdownPreReqs) StageFiles, {
+Task GenerateMarkdown -if (. $genMarkdownPreReqs) -Inputs {
+    if (Test-Path $PSBPreference.Build.ModuleOutDir) {
+        Get-ChildItem -Path $PSBPreference.Build.ModuleOutDir -Recurse -File -Include '*.ps1', '*.psm1'
+    }
+} -Outputs {
+    if (Test-Path $PSBPreference.Docs.RootDir) {
+        Get-ChildItem -Path $PSBPreference.Docs.RootDir -Recurse -File -Filter '*.md'
+    }
+} StageFiles, {
     $buildMDParams = @{
         ModulePath            = $PSBPreference.Build.ModuleOutDir
         ModuleName            = $PSBPreference.General.ModuleName
@@ -141,7 +172,15 @@ $genHelpFilesPreReqs = {
 }
 
 # Synopsis: Generates MAML-based help from PlatyPS markdown files
-Task GenerateMAML -if (. $genHelpFilesPreReqs) GenerateMarkdown, {
+Task GenerateMAML -if (. $genHelpFilesPreReqs) -Inputs {
+    if (Test-Path $PSBPreference.Docs.RootDir) {
+        Get-ChildItem -Path $PSBPreference.Docs.RootDir -Recurse -File -Filter '*.md'
+    }
+} -Outputs {
+    if (Test-Path $PSBPreference.Build.ModuleOutDir) {
+        Get-ChildItem -Path $PSBPreference.Build.ModuleOutDir -Recurse -File -Filter '*-help.xml'
+    }
+} GenerateMarkdown, {
     Build-PSBuildMAMLHelp -Path $PSBPreference.Docs.RootDir -DestinationPath $PSBPreference.Build.ModuleOutDir
 }
 
@@ -155,7 +194,15 @@ $genUpdatableHelpPreReqs = {
 }
 
 # Synopsis: Create updatable help .cab file based on PlatyPS markdown help
-Task GenerateUpdatableHelp -if (. $genUpdatableHelpPreReqs) BuildHelp, {
+Task GenerateUpdatableHelp -if (. $genUpdatableHelpPreReqs) -Inputs {
+    if (Test-Path $PSBPreference.Build.ModuleOutDir) {
+        Get-ChildItem -Path $PSBPreference.Build.ModuleOutDir -Recurse -File -Filter '*-help.xml'
+    }
+} -Outputs {
+    if (Test-Path $PSBPreference.Help.UpdatableHelpOutDir) {
+        Get-ChildItem -Path $PSBPreference.Help.UpdatableHelpOutDir -Recurse -File -Filter '*.cab'
+    }
+} BuildHelp, {
     Build-PSBuildUpdatableHelp -DocsPath $PSBPreference.Docs.RootDir -OutputPath $PSBPreference.Help.UpdatableHelpOutDir
 }
 

PowerShellBuild/PowerShellBuild.psd1

@@ -1,17 +1,17 @@
 @{
     RootModule        = 'PowerShellBuild.psm1'
-    ModuleVersion     = '0.8.0'
+    ModuleVersion     = '1.0.0'
     GUID              = '15431eb8-be2d-4154-b8ad-4cb68a488e3d'
     Author            = 'Brandon Olin'
     CompanyName       = 'Community'
     Copyright         = '(c) Brandon Olin. All rights reserved.'
     Description       = 'A common psake and Invoke-Build task module for PowerShell projects'
-    PowerShellVersion = '3.0'
+    PowerShellVersion = '5.1'
     RequiredModules   = @(
         @{ModuleName = 'BuildHelpers'; ModuleVersion = '2.0.16' }
         @{ModuleName = 'Pester'; ModuleVersion = '5.6.1' }
         @{ModuleName = 'platyPS'; ModuleVersion = '0.14.1' }
-        @{ModuleName = 'psake'; ModuleVersion = '4.9.0' }
+        @{ModuleName = 'psake'; ModuleVersion = '5.0.0' }
     )
     FunctionsToExport = @(
         'Build-PSBuildMAMLHelp'
@@ -26,12 +26,14 @@
         'Publish-PSBuildModule'
         'Test-PSBuildPester'
         'Test-PSBuildScriptAnalysis'
+        'Format-PSBuildResult'
     )
     CmdletsToExport   = @()
     VariablesToExport = @()
     AliasesToExport   = @('*tasks')
     PrivateData       = @{
         PSData = @{
+            Prerelease   = 'alpha1'
             Tags         = @('psake', 'build', 'InvokeBuild')
             LicenseUri   = 'https://raw.githubusercontent.com/psake/PowerShellBuild/master/LICENSE'
             ProjectUri   = 'https://github.com/psake/PowerShellBuild'

PowerShellBuild/PowerShellBuild.psm1

@@ -36,6 +36,23 @@ PSScriptAnalyzerResults=PSScriptAnalyzer results:
 ScriptAnalyzerErrors=One or more ScriptAnalyzer errors were found!
 ScriptAnalyzerWarnings=One or more ScriptAnalyzer warnings were found!
 ScriptAnalyzerIssues=One or more ScriptAnalyzer issues were found!
+NoCertificateFound=No valid code signing certificate was found. Verify the configured CertificateSource and that a certificate with a private key is available.
+CertificateResolvedFromStore=Resolved code signing certificate from store [{0}]: Subject=[{1}]
+CertificateResolvedFromThumbprint=Resolved code signing certificate by thumbprint [{0}]: Subject=[{1}]
+CertificateResolvedFromEnvVar=Resolved code signing certificate from environment variable [{0}]
+CertificateResolvedFromPfxFile=Resolved code signing certificate from PFX file [{0}]
+SigningModuleFiles=Signing [{0}] file(s) matching [{1}] in [{2}]...
+CreatingFileCatalog=Creating file catalog [{0}] (version {1})...
+FileCatalogCreated=File catalog created: [{0}]
+CertificateSourceAutoResolved=CertificateSource is 'Auto'. Resolved to '{0}'.
+CertificateMissingPrivateKey=The resolved certificate does not have an accessible private key. Code signing requires a certificate with a private key. Subject=[{0}]
+CertificateExpired=The resolved certificate has expired (NotAfter: {0}). Code signing requires a valid, unexpired certificate. Subject=[{1}]
+CertificateMissingCodeSigningEku=The resolved certificate does not have the Code Signing Enhanced Key Usage (EKU: 1.3.6.1.5.5.7.3.3). Subject=[{0}]
+CertificateSourceStoreNotSupported=CertificateSource 'Store' is only supported on Windows platforms.
+LLMOutputHeader=Test results (structured output):
+MinimalFailureLine=[FAIL] {0} ({1}:{2}) - {3}
+PesterConfigLoaded=Loaded PesterConfiguration from [{0}]
+InvalidPesterConfigPath=PesterConfiguration file [{0}] not found
 '@
 }
 $importLocalizedDataSplat = @{

PowerShellBuild/Private/ConvertTo-PSBuildLLMOutput.ps1

@@ -0,0 +1,85 @@
+function ConvertTo-PSBuildLLMOutput {
+    <#
+    .SYNOPSIS
+        Converts Pester test results to structured JSON optimized for LLM consumption.
+    .DESCRIPTION
+        Takes a Pester TestResult (PassThru) object and produces a concise JSON structure
+        containing a summary and an array of failure details. Designed for machine consumption
+        where only actionable information (failures) matters.
+    .PARAMETER TestResult
+        The Pester test result object returned by Invoke-Pester with -PassThru.
+    #>
+    [CmdletBinding()]
+    [OutputType([string])]
+    param(
+        [Parameter(Mandatory)]
+        [object]$TestResult
+    )
+
+    $failures = [System.Collections.Generic.List[object]]::new()
+
+    foreach ($container in $TestResult.Containers) {
+        Get-FailedTestsFromBlock -Blocks $container.Blocks -ContainerName $container.Name -Failures $failures
+    }
+
+    $output = [ordered]@{
+        summary  = [ordered]@{
+            total    = $TestResult.TotalCount
+            passed   = $TestResult.PassedCount
+            failed   = $TestResult.FailedCount
+            skipped  = $TestResult.SkippedCount
+            duration = [Math]::Round($TestResult.Duration.TotalSeconds, 2)
+        }
+        failures = $failures.ToArray()
+    }
+
+    $output | ConvertTo-Json -Depth 10
+}
+
+function Get-FailedTestsFromBlock {
+    <#
+    .SYNOPSIS
+        Recursively collects failed tests from Pester block hierarchy.
+    #>
+    [CmdletBinding()]
+    param(
+        [object[]]$Blocks,
+        [string]$ContainerName,
+        [System.Collections.Generic.List[object]]$Failures
+    )
+
+    foreach ($block in $Blocks) {
+        foreach ($test in $block.Tests) {
+            if ($test.Result -eq 'Failed') {
+                $errorMessage = if ($test.ErrorRecord -and $test.ErrorRecord.Count -gt 0) {
+                    $test.ErrorRecord[0].DisplayErrorMessage
+                } elseif ($test.ErrorRecord) {
+                    "$($test.ErrorRecord)"
+                } else {
+                    'Unknown error'
+                }
+
+                $file = $null
+                $line = $null
+                if ($test.ScriptBlock -and $test.ScriptBlock.File) {
+                    $file = $test.ScriptBlock.File
+                    $line = $test.ScriptBlock.StartPosition.StartLine
+                }
+
+                $Failures.Add([ordered]@{
+                    test      = $test.ExpandedPath
+                    container = $ContainerName
+                    file      = $file
+                    line      = $line
+                    error     = $errorMessage
+                    duration  = [Math]::Round($test.Duration.TotalMilliseconds, 1)
+                })
+            }
+        }
+
+        # Recurse into nested blocks
+        if ($block.Blocks -and $block.Blocks.Count -gt 0) {
+            Get-FailedTestsFromBlock -Blocks $block.Blocks -ContainerName $ContainerName -Failures $Failures
+        }
+    }
+}