Migrate all the .csproj files to SDK format

- Created convertToSDK script in Build folder
- Updated mkall.targets RestoreNuGet to use dotnet restore
- Update mkall.targets to use dotnet restore instead of old NuGet restore
- Update build scripts to use RestorePackages target

Implement and execute improved convertToSDK.py

* Use mkall.targets-based NuGet detection
* Fix test package references causing build failures
* Add PrivateAssets to test packages to exclude transitive deps

  SDK-style PackageReferences automatically include transitive
  dependencies. The SIL.LCModel.*.Tests packages depend on
  TestHelper, which causes NU1102 errors. Adding PrivateAssets="All"
  prevents transitive dependencies from flowing to consuming
  projects

Co-authored-by: jasonleenaylor <2295227+jasonleenaylor@users.noreply.github.com>

Convert DesktopAnalytics and IPCFramework to PackageReferences

Converted regular References to PackageReferences for NuGet packages:
- SIL.DesktopAnalytics (version 4.0.0) in 6 projects
- SIL.FLExBridge.IPCFramework (version 1.1.1-beta0001) in FwUtils
- Updated package versions to resolve NU1605 downgrade errors:
- Moq: 4.17.2 → 4.20.70 in XMLViewsTests.csproj
- TagLibSharp: 2.2.0 → 2.3.0 in xWorks.csproj

Co-authored-by: jasonleenaylor <2295227+jasonleenaylor@users.noreply.github.com>

Fix bare References and update convertToSDK.py script

* Fixed bare Reference elements in FieldWorks.csproj and
  XMLViews.csproj that should have been PackageReferences:
- Geckofx60.32/64 packages (provide Geckofx-Core, Geckofx-Winforms)
- SharpZipLib (provides ICSharpCode.SharpZipLib)
- SIL.ParatextShared (provides ParatextShared)
- FwControls.csproj: ParatextShared → SIL.ParatextShared
- ITextDll.csproj: Geckofx, SharpZipLib, ParatextShared → packages
- FwParatextLexiconPlugin.csproj: Paratext.LexicalContracts → ParatextData
- ScriptureUtilsTests.csproj: ParatextShared → SIL.ParatextShared
- Paratext8Plugin.csproj: Paratext.LexicalContracts → removed (provided by ParatextData)
- FwParatextLexiconPluginTests.csproj: Paratext.LexicalContracts* → ParatextData
- ParatextImportTests.csproj: ParatextShared → SIL.ParatextShared

Co-authored-by: jasonleenaylor <2295227+jasonleenaylor@users.noreply.github.com>

Fix Geckofx version and DotNetZip warnings

Updated Geckofx60.32/64 from 60.0.50/51 to 60.0.52 (only
version available on NuGet). This resolves NU1603 warnings
about missing package version 60.0.51.

Updated SharpZipLib in ITextDll.csproj from 1.3.3 to 1.4.0
to avoid downgrade warning (SIL.LCModel requires >= 1.4.0).

Suppressed DotNetZip NU1903 security warning in xWorks.csproj
and xWorksTests.csproj (already suppressed globally in
Directory.Build.props, but some projects need local suppression).

All 115 projects now restore successfully without errors.

Co-authored-by: jasonleenaylor <2295227+jasonleenaylor@users.noreply.github.com>

Fix post .csproj conversion build issues

* Add excludes for test subdirectories
* Fix several references that should have been PackageReferences
* Fix Resource ambiguity
* Add c++ projects to the solution

Delete some obsolete files and clean-up converted .csproj

* Fix more encoding converter and geckofx refs
* Delete obsolete projects
* Delete obsoleted test fixture

Copilot assisted NUnit3 to NUnit4 migration

* Also removed some obsolete tests and clean up some incomplete
  reference conversions

Update palaso dependencies and remove GeckoFx 32bit

* The conditional 32/64 bit dependency was causing issues
  and wasn't necessary since we aren't shipping 32 bit anymore

Fix broken test projects by adding needed external dependencies

* Mark as test projects and include test adapter
* Add .config file and DependencyModel package if needed
* Add AssemblyInfoForTests.cs link if needed
* Also fix issues caused by a stricter compiler in net48

Update FieldWorks.cs to use latest dependencies

* Update L10nSharp calls
* Specify the LCModel BackupProjectSettings
* Add CommonAsssemblyInfo.cs link lost in conversion
* Set Deterministic builds to false for now (evaluate later)

Spec kit and AI docs, tasks and instructions

Refine AI onboarding and workflows:
* Update copilot-instructions.md with agentic workflow links and
clearer pointers to src-catalog and per-folder guidance (COPILOT.md).
* Tune native and installer instructions for mixed C++/CLI, WiX, and build
nuances (interop, versioning, upgrade behavior, build gotchas).

Spec kit improvements:
* Refresh spec.md and plan.md to align with the
feature-spec and bugfix agent workflows and FieldWorks conventions.
Inner-loop productivity:
* Extend tasks.json with quick checks for whitespace and commit
message linting to mirror CI and shorten feedback loops.

CI hardening for docs and future agent flows:
* Add lint-docs.yml to verify COPILOT.md presence per
Src/<Folder> and ensure folders are referenced in .github/src-catalog.md.
* Add agent-analysis-stub.yml (disabled-by-default) to
document how we will run prompts/test-failure analysis in CI later.

Locally run CI checks in Powershell
* Refactor scripts and add whitespace fixing algorithm
* Add system to keep track of changes needed to be reflected in
  COPILOT.md files.

Use FieldWorks.proj for main file
Add local mulit-agent capability
Remove LexTextExe.exe

Author: jasonleenaylor

.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)