[CmdletBinding(DefaultParameterSetName = 'Task')]

param(

# Build task(s) to execute

[parameter(ParameterSetName = 'task', position = 0)]

[ArgumentCompleter({

param($Command, $Parameter, $WordToComplete, $CommandAst, $FakeBoundParams)

try {

Get-PSakeScriptTasks -BuildFile './psakeFile.ps1' -ErrorAction 'Stop' |

Where-Object { $_.Name -like "$WordToComplete*" } |

Select-Object -ExpandProperty 'Name'

} catch {

@()

}

})]

[string[]] $Task = 'default',

# Bootstrap dependencies

[switch] $Bootstrap,

# List available build tasks

[parameter(ParameterSetName = 'Help')]

[switch] $Help,

# Suppress console output; returns structured PsakeBuildResult.

# LLM should prefer this option.

[switch] $Quiet,

# Bypass task caching for this run

[switch] $NoCache,

# Output format for CI integration

[ValidateSet('Default', 'JSON', 'GitHubActions')]

[string] $OutputFormat = 'Default',

# Optional properties to pass to psake

[hashtable] $Properties,

# Optional parameters to pass to psake

[hashtable] $Parameters

)

$ErrorActionPreference = 'Stop'

if ($Bootstrap) {

PackageManagement\Get-PackageProvider -Name Nuget -ForceBootstrap | Out-Null

Set-PSRepository -Name PSGallery -InstallationPolicy Trusted

if (Test-Path -Path './requirements.psd1') {

if (-not (Get-Module -Name PSDepend -ListAvailable)) {

Install-Module -Name PSDepend -Repository PSGallery -Scope CurrentUser -Force

}

Import-Module -Name PSDepend -Verbose:$false

Invoke-PSDepend -Path './requirements.psd1' -Install -Force -WarningAction SilentlyContinue

} else {

Write-Warning 'No [requirements.psd1] found. Skipping build dependency installation.'

}

}

$psakeFile = './psakeFile.ps1'

if ($PSCmdlet.ParameterSetName -eq 'Help') {

Get-PSakeScriptTasks -BuildFile $psakeFile |

Format-Table -Property Name, Description, Alias, DependsOn

} else {

$invokeSplat = @{

BuildFile = $psakeFile

TaskList = $Task

NoLogo = $true

Properties = $Properties

Parameters = $Parameters

Quiet = $Quiet

NoCache = $NoCache

OutputFormat = $OutputFormat

}

$result = Invoke-Psake @invokeSplat

exit ([int](-not $result.Success))

}