MegaBites-AI/Windows-powershell

1---2applyTo:3  - "build.psm1"4  - "tools/ci.psm1"5  - ".github/**/*.yml"6  - ".github/**/*.yaml"7---8 9# Start-PSBuild Basics10 11## Purpose12 13`Start-PSBuild` builds PowerShell from source. It's defined in `build.psm1` and used in CI/CD workflows.14 15## Default Usage16 17For most scenarios, use with no parameters:18 19```powershell20Import-Module ./tools/ci.psm121Start-PSBuild22```23 24**Default behavior:**25- Configuration: `Debug`26- PSModuleRestore: Enabled27- Runtime: Auto-detected for platform28 29## Common Configurations30 31### Debug Build (Default)32 33```powershell34Start-PSBuild35```36 37Use for:38- Testing (xUnit, Pester)39- Development40- Debugging41 42### Release Build43 44```powershell45Start-PSBuild -Configuration 'Release'46```47 48Use for:49- Production packages50- Distribution51- Performance testing52 53### Code Coverage Build54 55```powershell56Start-PSBuild -Configuration 'CodeCoverage'57```58 59Use for:60- Code coverage analysis61- Test coverage reports62 63## Common Parameters64 65### -Configuration66 67Values: `Debug`, `Release`, `CodeCoverage`, `StaticAnalysis`68 69Default: `Debug`70 71### -CI72 73Restores Pester module for CI environments.74 75```powershell76Start-PSBuild -CI77```78 79### -PSModuleRestore80 81Now enabled by default. Use `-NoPSModuleRestore` to skip.82 83### -ReleaseTag84 85Specifies version tag for release builds:86 87```powershell88$releaseTag = Get-ReleaseTag89Start-PSBuild -Configuration 'Release' -ReleaseTag $releaseTag90```91 92## Workflow Example93 94```yaml95- name: Build PowerShell96  shell: pwsh97  run: |98    Import-Module ./tools/ci.psm199    Start-PSBuild100```101