Spec kit and modern building

.dockerignore

@@ -0,0 +1,87 @@
+# Build outputs
+Output/
+Obj/
+bin/
+obj/
+*.user
+
+# Test results
+TestResults/
+
+# NuGet packages
+packages/
+.nuget/
+
+# Git
+.git/
+.github/
+.gitignore
+.gitattributes
+
+# Visual Studio
+.vs/
+*.suo
+*.sln.docstates
+
+# Documentation and analysis files
+*.md
+!ReadMe.md
+COPILOT.md
+*.prompt.md
+BUILD_CHALLENGES_ANALYSIS.md
+CLARIFICATIONS-NEEDED.md
+COMPREHENSIVE_COMMIT_ANALYSIS.md
+CONVERGENCE-FRAMEWORK.md
+CONVERGENCE-STATUS.md
+DEEP_COMMIT_ANALYSIS.md
+DLL_MODERNIZATION_PLAN.md
+LEGACY_REMOVAL_SUMMARY.md
+MIGRATION_DOCS_INDEX.md
+MIGRATION_FIXES_SUMMARY.md
+MIGRATION_SUMMARY_BY_PHASE.md
+NON_SDK_ELIMINATION.md
+NUNIT4_CONVERSION_SUMMARY.md
+PACKAGE_MANAGEMENT_QUICKSTART.md
+RHINOMOCKS_TO_MOQ_MIGRATION.md
+SDK-MIGRATION.md
+TRAVERSAL_SDK_IMPLEMENTATION.md
+
+# Test projects and data
+TestLangProj/
+specs/
+
+# Vagrant
+vagrant/
+
+# Python scripts (not needed in container)
+*.py
+
+# Docs
+Docs/
+
+# Resources (will copy specific ones if needed)
+resources/
+
+# Scripts (not needed for Docker build)
+scripts/
+
+# FLExInstaller (not building installer in container)
+FLExInstaller/
+
+# Sample/test code
+Samples/
+
+# Large binary files
+*.exe
+!DistFiles/**/*.exe
+*.dll
+!DistFiles/**/*.dll
+*.pdb
+*.lib
+*.exp
+
+# Temporary files
+*.tmp
+*.log
+*.bak
+*~

.github/BUILD_REQUIREMENTS.md

@@ -0,0 +1,87 @@
+# Build Requirements
+
+## Local Development
+
+### Full Build (C# + Native C++)
+
+To build the complete FieldWorks solution including native C++ components:
+
+**PowerShell (Recommended - auto-initializes VS environment):**
+```powershell
+.\build.ps1
+```
+
+**Bash (Git Bash - requires Developer Command Prompt):**
+```bash
+# 1. Open "Developer Command Prompt for VS 2022" from Start Menu
+# 2. Type: bash
+# 3. Navigate to repo: cd /c/path/to/FieldWorks
+# 4. Run: ./build.sh
+```
+
+**Why?** Native components (DebugProcs, GenericLib, FwKernel, Views, graphite2) require:
+- `nmake.exe` (from Visual Studio C++ Build Tools)
+- C++ compiler toolchain
+- Environment variables set by VsDevCmd.bat (VCINSTALLDIR, INCLUDE, LIB, etc.)
+
+**Note:** The PowerShell script (`build.ps1`) automatically initializes the Visual Studio environment using `vswhere.exe`. The Bash script requires you to run from a Developer Command Prompt because Git Bash has issues reliably calling VsDevCmd.bat.
+
+### Managed-Only Build (C# projects)
+
+If you only need to build C# projects and already have native artifacts from a previous build:
+
+```powershell
+# Build only managed projects (skips native C++)
+msbuild FieldWorks.proj /p:Configuration=Debug /p:Platform=x64
+```
+
+## CI Builds
+
+GitHub Actions CI automatically configures the Developer environment using the `microsoft/setup-msbuild@v2` action. No manual setup is required.
+
+From `.github/workflows/CI.yml`:
+```yaml
+- name: Setup MSBuild
+  uses: microsoft/setup-msbuild@v2  # Configures VS environment automatically
+
+- name: Build Debug and run tests
+  run: ./build.ps1 -Configuration Debug -Platform x64
+```
+
+## Troubleshooting
+
+### Error: "nmake.exe could not be run" or "VCINSTALLDIR not set"
+
+**Cause:** Build script was run from a regular PowerShell/bash session instead of a Developer Command Prompt.
+
+**Solution:**
+1. Close your current terminal
+2. Open "Developer Command Prompt for VS 2022" or "Developer PowerShell for VS 2022" from the Start Menu
+3. Navigate to the repository
+4. Run the build script again
+
+### Error: "Missing FieldWorks build tasks assembly"
+
+**Cause:** FwBuildTasks.dll hasn't been built yet (typically on first build or after clean).
+
+**Solution:** The build scripts now automatically bootstrap FwBuildTasks. If this fails, manually build it first:
+```powershell
+msbuild Build/Src/FwBuildTasks/FwBuildTasks.csproj /t:Restore;Build /p:Configuration=Debug
+```
+
+## Build Script Features
+
+Both `build.ps1` and `build.sh` now include:
+
+1. **Automatic FwBuildTasks bootstrap**: Builds build infrastructure before main build
+2. **Environment validation**: Warns if Developer environment is not detected
+3. **Package restoration**: Restores NuGet packages before build
+4. **Traversal build**: Uses MSBuild Traversal SDK (FieldWorks.proj) for correct dependency ordering
+
+## Visual Studio Requirements
+
+- **Visual Studio 2022** (Community, Professional, or Enterprise)
+- **Required Workloads:**
+  - .NET desktop development
+  - Desktop development with C++
+- **Optional:** WiX Toolset 3.11.x (only for installer builds)