Copilot instructions

1---
2applyTo:
3  - "build.psm1"
4  - "tools/ci.psm1"
5  - ".github/**/*.yml"
6  - ".github/**/*.yaml"
7---
8 
9# Start-PSBuild Basics
10 
11## Purpose
12 
13`Start-PSBuild` builds PowerShell from source. It's defined in `build.psm1` and used in CI/CD workflows.
14 
15## Default Usage
16 
17For most scenarios, use with no parameters:
18 
19```powershell
20Import-Module ./tools/ci.psm1
21Start-PSBuild
22```
23 
24**Default behavior:**
25- Configuration: `Debug`
26- PSModuleRestore: Enabled
27- Runtime: Auto-detected for platform
28 
29## Common Configurations
30 
31### Debug Build (Default)
32 
33```powershell
34Start-PSBuild
35```
36 
37Use for:
38- Testing (xUnit, Pester)
39- Development
40- Debugging
41 
42### Release Build
43 
44```powershell
45Start-PSBuild -Configuration 'Release'
46```
47 
48Use for:
49- Production packages
50- Distribution
51- Performance testing
52 
53### Code Coverage Build
54 
55```powershell
56Start-PSBuild -Configuration 'CodeCoverage'
57```
58 
59Use for:
60- Code coverage analysis
61- Test coverage reports
62 
63## Common Parameters
64 
65### -Configuration
66 
67Values: `Debug`, `Release`, `CodeCoverage`, `StaticAnalysis`
68 
69Default: `Debug`
70 
71### -CI
72 
73Restores Pester module for CI environments.
74 
75```powershell
76Start-PSBuild -CI
77```
78 
79### -PSModuleRestore
80 
81Now enabled by default. Use `-NoPSModuleRestore` to skip.
82 
83### -ReleaseTag
84 
85Specifies version tag for release builds:
86 
87```powershell
88$releaseTag = Get-ReleaseTag
89Start-PSBuild -Configuration 'Release' -ReleaseTag $releaseTag
90```
91 
92## Workflow Example
93 
94```yaml
95- name: Build PowerShell
96  shell: pwsh
97  run: |
98    Import-Module ./tools/ci.psm1
99    Start-PSBuild
100```
101