Copilot instructions

1---
2applyTo:
3  - "build.psm1"
4  - "tools/ci.psm1"
5  - ".github/**/*.yml"
6  - ".github/**/*.yaml"
7---
8 
9# Troubleshooting Build Issues
10 
11## Git Describe Error
12 
13**Error:**
14```
15error MSB3073: The command "git describe --abbrev=60 --long" exited with code 128.
16```
17 
18**Cause:** Insufficient git history (shallow clone)
19 
20**Solution:** Add `fetch-depth: 1000` to checkout step
21 
22```yaml
23- name: Checkout
24  uses: actions/checkout@v4
25  with:
26    fetch-depth: 1000
27```
28 
29## Version Information Incorrect
30 
31**Symptom:** Build produces wrong version numbers
32 
33**Cause:** Git tags not synchronized
34 
35**Solution:** Run `Sync-PSTags -AddRemoteIfMissing`:
36 
37```yaml
38- name: Bootstrap
39  shell: pwsh
40  run: |
41    Import-Module ./tools/ci.psm1
42    Invoke-CIInstall -SkipUser
43    Sync-PSTags -AddRemoteIfMissing
44```
45 
46## PowerShell Binary Not Built
47 
48**Error:**
49```
50Exception: CoreCLR pwsh.exe was not built
51```
52 
53**Causes:**
541. Build failed (check logs)
552. Wrong configuration used
563. Build output location incorrect
57 
58**Solutions:**
591. Check build logs for errors
602. Verify correct configuration for use case
613. Use default parameters: `Start-PSBuild`
62 
63## Module Restore Issues
64 
65**Symptom:** Slow build or module restore failures
66 
67**Causes:**
68- Network issues
69- Module cache problems
70- Package source unavailable
71 
72**Solutions:**
731. Retry the build
742. Check network connectivity
753. Use `-NoPSModuleRestore` if modules not needed
764. Clear package cache if persistent
77 
78## .NET SDK Not Found
79 
80**Symptom:** Build can't find .NET SDK
81 
82**Solution:** Ensure .NET setup step runs first:
83 
84```yaml
85- name: Setup .NET
86  uses: actions/setup-dotnet@v4
87  with:
88    global-json-file: ./global.json
89```
90 
91## Bootstrap Failures
92 
93**Symptom:** Invoke-CIInstall fails
94 
95**Causes:**
96- Missing dependencies
97- Network issues
98- Platform-specific requirements not met
99 
100**Solution:** Check prerequisites for your platform in build system docs
101