Add local LCM source mode workflow

[johnml1135]

Summary

• replace the old local liblcm overlay flow with an explicit local-source workflow rooted at Localizations/LCM
• add FieldWorks.LocalLcm.sln, repo-wide UseLocalLcmSource wiring, and build.ps1 -LcmMode Auto|Package|Local
• add VS Code package/local launchers plus a prelaunch wrapper that skips rebuilds when no relevant saved files changed
• refresh local LCM runtime outputs into Output/Debug for VS Code symbol loading and keep portable PDBs for the clr debugger path
• update setup and architecture docs to describe the nested-checkout workflow and remove the old overlay script

Review findings addressed

• fixed a local-source bootstrap deadlock by bootstrapping SIL.LCModel.Build.Tasks.dll from source when local artifacts are missing
• fixed the VS Code prelaunch change detector so directory-level deletes and renames trigger rebuilds instead of launching stale binaries

Validation

• ./build.ps1 -LcmMode Local -ManagedDebugType portable -SkipDependencyCheck
• ./Build/Agent/Invoke-VsCodeDebugBuild.ps1 -LcmMode Local -ManagedDebugType portable

---

This change is 

[Copilot]

Pull request overview

This PR replaces the previous “overlay/copy local liblcm outputs” approach with an explicit, repo-wide local-source mode rooted at Localizations/LCM, including dedicated build entrypoints and improved VS Code debugging ergonomics.

Changes:

• Introduces -LcmMode Auto|Package|Local and -ManagedDebugType into build.ps1, plus local-source detection/state reporting and runtime-output syncing for VS Code symbols.
• Adds FieldWorks.LocalLcm.sln and MSBuild wiring (UseLocalLcmSource, package→project reference switching, build-task bootstrapping).
• Updates developer setup + VS Code tasks/launchers, and improves toolchain discovery (MSVC path selection).

Reviewed changes

Copilot reviewed 21 out of 21 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
scripts/Agent/Copy-LocalLcm.ps1	Removes the old “copy locally-built LCM DLLs over NuGet outputs” flow.
build.ps1	Adds LcmMode + ManagedDebugType, local-source selection, and symbol/runtime-output refresh.
Src/Common/SimpleRootSite/EditingHelper.cs	Disposes VwPropertyStoreManaged via using.
Src/Common/FwUtils/FwUtilsTests/TestFwStylesheetTests.cs	Disposes VwPropertyStoreManaged in tests via using.
Src/Common/FieldWorks/FieldWorks.csproj	Enables unmanaged debugging for the FieldWorks project.
Src/Common/Controls/Widgets/FontHeightAdjuster.cs	Disposes VwPropertyStoreManaged via using.
Setup-Developer-Machine.ps1	Installs .NET SDK 8.x when missing; adjusts helper-repo cloning/junction behavior for worktrees; clones liblcm nested.
FieldWorks.LocalLcm.sln	Adds a dedicated solution that includes local liblcm projects for local-source mode.
Docs/architecture/liblcm-local-source-checklist.md	Documents the migration checklist and expectations for local-source mode.
Docs/architecture/liblcm-debugging.md	Adds detailed debugging guidance for package vs local-source liblcm workflows.
Docs/architecture/dependencies.md	Points dependency debugging guidance to the new liblcm debugging doc and summarizes the workflow.
DistFiles/Parts/StandardParts.xml	Adds new part definitions (ImportResidue/Pictures).
Directory.Build.targets	Adds package→project reference switching for LCM + build-task bootstrapping/validation targets.
Directory.Build.props	Adds UseLocalLcmSource defaults for FieldWorks.LocalLcm and redirects LCM paths/artifacts to nested checkout.
Build/Src/FwBuildTasks/Make.cs	Improves MSVC tool path detection under modern VS layouts.
Build/Agent/Invoke-VsCodeDebugBuild.ps1	Adds VS Code prelaunch build wrapper with change detection + mode/debug-type stamping.
Build/Agent/FwBuildEnvironment.psm1	Prefers HostX64\x64 MSVC bin path early in PATH.
.vscode/tasks.json	Adds explicit package/local build tasks and “prepare debug” tasks; defaults Build to -LcmMode Auto.
.vscode/launch.json	Adds package vs local-LCM launch configs with prelaunch tasks + symbol search paths.
.vscode/extensions.json	Recommends the official C# extension while keeping Dev Kit unwanted (ReSharper-first).
.serena/project.yml	Adds Serena config keys for line ending and read-only memory patterns.

[github-actions]

NUnit Tests

    1 files  ±  0      1 suites  ±0   6m 7s ⏱️ +23s
4 414 tests +356  4 327 ✅ +340  87 💤 +16  0 ❌ ±0 
4 423 runs  +356  4 336 ✅ +340  87 💤 +16  0 ❌ ±0 

Results for commit 899d70c. ± Comparison against base commit d58727c.

This pull request removes 26 and adds 382 tests. Note that renamed tests count towards both.

SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ BasicAscii_EachCharSeparate
SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ CombiningDiacriticFollowsBase_GroupedWithBase
SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ DiacriticsPrecedeBase_DiacriticBeforeBase_ThenAnotherBase
SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ DiacriticsPrecedeBase_DiacriticSeparateFromFollowingBase
SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ DiacriticsPrecedeBase_MultipleDiacritics_EachSeparate
SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ Digits_EachSeparate
SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ EmptyString_ReturnsEmpty
SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ GetReferences_EmptyLines_Skipped
SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ GetReferences_ReturnsCorrectOffsetsAndLengths
SIL.FieldWorks.Common.FwUtils.ParseCharacterSequencesTests ‑ GetReferences_SupplementaryCharacters_CorrectOffsets
…

SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ CapitalizedHeading
SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ CapitalizedList
SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ CapitalizedProperName_NotParaStart
SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ CapitalizedProperName_ParaStart
SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ CapitalizedTableCellHead
SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ CapitalizedTitle
SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ Footnotes_TreatedSeparately
SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ GetLengthOfChar
SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ LCaseInRunAfterNote
SILUBS.ScriptureChecks.CapitalizationCheckSilUnitTest ‑ LCaseInRunAfterPicture
…

♻️ This comment has been updated with latest results.

[johnml1135]

Cleaned up this PR to match the review feedback and the split described in the local-source plan.

What changed:

• split the Windows build-toolchain work into a separate PR: Improve Visual Studio toolchain detection for Windows builds #766
• removed the toolchain-only files from this branch:
  • Build/Agent/FwBuildEnvironment.psm1
  • Build/Agent/Verify-FwDependencies.ps1
  • Build/Src/FwBuildTasks/Make.cs
• removed the unrelated DistFiles/Parts/StandardParts.xml change from this branch
• removed the planning/checklist markdown that was only used to drive the implementation:
  • Docs/architecture/liblcm-local-source-plan.md
  • Docs/architecture/liblcm-local-source-checklist.md
• squashed the remaining liblcm workflow work on this branch down to one commit for easier review

What remains in this PR is the local liblcm source-mode implementation and the supporting docs/debugger/build-flow changes that are directly part of that workflow.

The split toolchain PR is here for separate review: #766

[jasonleenaylor]

This PR looks like it has conflated two different uses of LCM locally, there is a localization related path used mostly by installers or by local testing of localization and the current focus of being able to test LCM fixes by integrating locally built packages and symbols.

The developer is presumed to have LCM cloned locally. The previous helper script would run pack on lcm and capture the version information out of the build log and modify the package references to point at the new version. It would also copy the symbol artifacts from the lcm build output into the fieldworks build output.

I think a cleaner and more developer configurable change would be to have a -LocalLcm parameter which takes a path to the lcm root folder. Validate that location, run dotnet pack in that location, change the lcm package version in the centralized packaging location for fieldworks, copy symbol files to output if necessary.

@jasonleenaylor reviewed all commit messages and made 1 comment.
Reviewable status: 0 of 131 files reviewed, all discussions resolved.